1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Read flash partition table from command line
5 * Copyright © 2002 SYSGO Real-Time Solutions GmbH
6 * Copyright © 2002-2010 David Woodhouse <dwmw2@infradead.org>
8 * The format for the command line is as follows:
10 * mtdparts=<mtddef>[;<mtddef]
11 * <mtddef> := <mtd-id>:<partdef>[,<partdef>]
12 * <partdef> := <size>[@<offset>][<name>][ro][lk][slc]
13 * <mtd-id> := unique name used in mapping driver/device (mtd->name)
14 * <size> := standard linux memsize OR "-" to denote all remaining space
15 * size is automatically truncated at end of device
16 * if specified or truncated size is 0 the part is skipped
17 * <offset> := standard linux memsize
18 * if omitted the part will immediately follow the previous part
19 * or 0 if the first part
20 * <name> := '(' NAME ')'
21 * NAME will appear in /proc/mtd
23 * <size> and <offset> can be specified such that the parts are out of order
24 * in physical memory and may even overlap.
26 * The parts are assigned MTD numbers in the order they are specified in the
27 * command line regardless of their order in physical memory.
31 * 1 NOR Flash, with 1 single writable partition:
34 * 1 NOR Flash with 2 partitions, 1 NAND with one
35 * edb7312-nor:256k(ARMboot)ro,-(root);edb7312-nand:-(home)
38 #define pr_fmt(fmt) "mtd: " fmt
40 #include <linux/kernel.h>
41 #include <linux/slab.h>
42 #include <linux/mtd/mtd.h>
43 #include <linux/mtd/partitions.h>
44 #include <linux/module.h>
45 #include <linux/err.h>
49 #define dbg(x) do { printk("DEBUG-CMDLINE-PART: "); printk x; } while(0)
55 /* special size referring to all the remaining space in a partition */
56 #define SIZE_REMAINING ULLONG_MAX
57 #define OFFSET_CONTINUOUS ULLONG_MAX
59 struct cmdline_mtd_partition
{
60 struct cmdline_mtd_partition
*next
;
63 struct mtd_partition
*parts
;
66 /* mtdpart_setup() parses into here */
67 static struct cmdline_mtd_partition
*partitions
;
69 /* the command line passed to mtdpart_setup() */
70 static char *mtdparts
;
72 static int cmdline_parsed
;
75 * Parse one partition definition for an MTD. Since there can be many
76 * comma separated partition definitions, this function calls itself
77 * recursively until no more partition definitions are found. Nice side
78 * effect: the memory to keep the mtd_partition structs and the names
79 * is allocated upon the last definition being found. At that point the
80 * syntax has been verified ok.
82 static struct mtd_partition
* newpart(char *s
,
86 unsigned char **extra_mem_ptr
,
89 struct mtd_partition
*parts
;
90 unsigned long long size
, offset
= OFFSET_CONTINUOUS
;
93 unsigned char *extra_mem
;
95 unsigned int mask_flags
, add_flags
;
97 /* fetch the partition size */
99 /* assign all remaining space to this partition */
100 size
= SIZE_REMAINING
;
103 size
= memparse(s
, &s
);
105 pr_err("partition has size 0\n");
106 return ERR_PTR(-EINVAL
);
110 /* fetch partition name and flags */
111 mask_flags
= 0; /* this is going to be a regular partition */
115 /* check for offset */
118 offset
= memparse(s
, &s
);
121 /* now look for name */
129 p
= strchr(name
, delim
);
131 pr_err("no closing %c found in partition name\n", delim
);
132 return ERR_PTR(-EINVAL
);
138 name_len
= 13; /* Partition_000 */
141 /* record name length for memory allocation later */
142 extra_mem_size
+= name_len
+ 1;
144 /* test for options */
145 if (strncmp(s
, "ro", 2) == 0) {
146 mask_flags
|= MTD_WRITEABLE
;
150 /* if lk is found do NOT unlock the MTD partition*/
151 if (strncmp(s
, "lk", 2) == 0) {
152 mask_flags
|= MTD_POWERUP_LOCK
;
156 /* if slc is found use emulated SLC mode on this partition*/
157 if (!strncmp(s
, "slc", 3)) {
158 add_flags
|= MTD_SLC_ON_MLC_EMULATION
;
162 /* test if more partitions are following */
164 if (size
== SIZE_REMAINING
) {
165 pr_err("no partitions allowed after a fill-up partition\n");
166 return ERR_PTR(-EINVAL
);
168 /* more partitions follow, parse them */
169 parts
= newpart(s
+ 1, &s
, num_parts
, this_part
+ 1,
170 &extra_mem
, extra_mem_size
);
174 /* this is the last partition: allocate space for all */
177 *num_parts
= this_part
+ 1;
178 alloc_size
= *num_parts
* sizeof(struct mtd_partition
) +
181 parts
= kzalloc(alloc_size
, GFP_KERNEL
);
183 return ERR_PTR(-ENOMEM
);
184 extra_mem
= (unsigned char *)(parts
+ *num_parts
);
188 * enter this partition (offset will be calculated later if it is
189 * OFFSET_CONTINUOUS at this point)
191 parts
[this_part
].size
= size
;
192 parts
[this_part
].offset
= offset
;
193 parts
[this_part
].mask_flags
= mask_flags
;
194 parts
[this_part
].add_flags
= add_flags
;
196 strlcpy(extra_mem
, name
, name_len
+ 1);
198 sprintf(extra_mem
, "Partition_%03d", this_part
);
199 parts
[this_part
].name
= extra_mem
;
200 extra_mem
+= name_len
+ 1;
202 dbg(("partition %d: name <%s>, offset %llx, size %llx, mask flags %x\n",
203 this_part
, parts
[this_part
].name
, parts
[this_part
].offset
,
204 parts
[this_part
].size
, parts
[this_part
].mask_flags
));
206 /* return (updated) pointer to extra_mem memory */
208 *extra_mem_ptr
= extra_mem
;
210 /* return (updated) pointer command line string */
213 /* return partition table */
218 * Parse the command line.
220 static int mtdpart_setup_real(char *s
)
226 struct cmdline_mtd_partition
*this_mtd
;
227 struct mtd_partition
*parts
;
228 int mtd_id_len
, num_parts
;
229 char *p
, *mtd_id
, *semicol
, *open_parenth
;
232 * Replace the first ';' by a NULL char so strrchr can work
235 semicol
= strchr(s
, ';');
240 * make sure that part-names with ":" will not be handled as
241 * part of the mtd-id with an ":"
243 open_parenth
= strchr(s
, '(');
245 *open_parenth
= '\0';
250 * fetch <mtd-id>. We use strrchr to ignore all ':' that could
251 * be present in the MTD name, only the last one is interpreted
252 * as an <mtd-id>/<part-definition> separator.
256 /* Restore the '(' now. */
260 /* Restore the ';' now. */
265 pr_err("no mtd-id\n");
268 mtd_id_len
= p
- mtd_id
;
270 dbg(("parsing <%s>\n", p
+1));
273 * parse one mtd. have it reserve memory for the
274 * struct cmdline_mtd_partition and the mtd-id string.
276 parts
= newpart(p
+ 1, /* cmdline */
277 &s
, /* out: updated cmdline ptr */
278 &num_parts
, /* out: number of parts */
279 0, /* first partition */
280 (unsigned char**)&this_mtd
, /* out: extra mem */
281 mtd_id_len
+ 1 + sizeof(*this_mtd
) +
282 sizeof(void*)-1 /*alignment*/);
285 * An error occurred. We're either:
286 * a) out of memory, or
287 * b) in the middle of the partition spec
288 * Either way, this mtd is hosed and we're
289 * unlikely to succeed in parsing any more
291 return PTR_ERR(parts
);
295 this_mtd
= (struct cmdline_mtd_partition
*)
296 ALIGN((unsigned long)this_mtd
, sizeof(void *));
298 this_mtd
->parts
= parts
;
299 this_mtd
->num_parts
= num_parts
;
300 this_mtd
->mtd_id
= (char*)(this_mtd
+ 1);
301 strlcpy(this_mtd
->mtd_id
, mtd_id
, mtd_id_len
+ 1);
303 /* link into chain */
304 this_mtd
->next
= partitions
;
305 partitions
= this_mtd
;
307 dbg(("mtdid=<%s> num_parts=<%d>\n",
308 this_mtd
->mtd_id
, this_mtd
->num_parts
));
311 /* EOS - we're done */
315 /* does another spec follow? */
317 pr_err("bad character after partition (%c)\n", *s
);
327 * Main function to be called from the MTD mapping driver/device to
328 * obtain the partitioning information. At this point the command line
329 * arguments will actually be parsed and turned to struct mtd_partition
330 * information. It returns partitions for the requested mtd device, or
331 * the first one in the chain if a NULL mtd_id is passed in.
333 static int parse_cmdline_partitions(struct mtd_info
*master
,
334 const struct mtd_partition
**pparts
,
335 struct mtd_part_parser_data
*data
)
337 unsigned long long offset
;
339 struct cmdline_mtd_partition
*part
;
340 const char *mtd_id
= master
->name
;
342 /* parse command line */
343 if (!cmdline_parsed
) {
344 err
= mtdpart_setup_real(cmdline
);
350 * Search for the partition definition matching master->name.
351 * If master->name is not set, stop at first partition definition.
353 for (part
= partitions
; part
; part
= part
->next
) {
354 if ((!mtd_id
) || (!strcmp(part
->mtd_id
, mtd_id
)))
361 for (i
= 0, offset
= 0; i
< part
->num_parts
; i
++) {
362 if (part
->parts
[i
].offset
== OFFSET_CONTINUOUS
)
363 part
->parts
[i
].offset
= offset
;
365 offset
= part
->parts
[i
].offset
;
367 if (part
->parts
[i
].size
== SIZE_REMAINING
)
368 part
->parts
[i
].size
= master
->size
- offset
;
370 if (offset
+ part
->parts
[i
].size
> master
->size
) {
371 pr_warn("%s: partitioning exceeds flash size, truncating\n",
373 part
->parts
[i
].size
= master
->size
- offset
;
375 offset
+= part
->parts
[i
].size
;
377 if (part
->parts
[i
].size
== 0) {
378 pr_warn("%s: skipping zero sized partition\n",
381 memmove(&part
->parts
[i
], &part
->parts
[i
+ 1],
382 sizeof(*part
->parts
) * (part
->num_parts
- i
));
387 *pparts
= kmemdup(part
->parts
, sizeof(*part
->parts
) * part
->num_parts
,
392 return part
->num_parts
;
397 * This is the handler for our kernel parameter, called from
398 * main.c::checksetup(). Note that we can not yet kmalloc() anything,
399 * so we only save the commandline for later processing.
401 * This function needs to be visible for bootloaders.
403 static int __init
mtdpart_setup(char *s
)
409 __setup("mtdparts=", mtdpart_setup
);
411 static struct mtd_part_parser cmdline_parser
= {
412 .parse_fn
= parse_cmdline_partitions
,
413 .name
= "cmdlinepart",
416 static int __init
cmdline_parser_init(void)
419 mtdpart_setup(mtdparts
);
420 register_mtd_parser(&cmdline_parser
);
424 static void __exit
cmdline_parser_exit(void)
426 deregister_mtd_parser(&cmdline_parser
);
429 module_init(cmdline_parser_init
);
430 module_exit(cmdline_parser_exit
);
432 MODULE_PARM_DESC(mtdparts
, "Partitioning specification");
433 module_param(mtdparts
, charp
, 0);
435 MODULE_LICENSE("GPL");
436 MODULE_AUTHOR("Marius Groeger <mag@sysgo.de>");
437 MODULE_DESCRIPTION("Command line configuration of MTD partitions");