2 * Simple MTD partitioning layer
4 * (C) 2000 Nicolas Pitre <nico@cam.org>
8 * $Id: mtdpart.c,v 1.46 2004/07/12 13:28:07 dwmw2 Exp $
10 * 02-21-2002 Thomas Gleixner <gleixner@autronix.de>
11 * added support for read_oob, write_oob
14 #include <linux/module.h>
15 #include <linux/types.h>
16 #include <linux/kernel.h>
17 #include <linux/slab.h>
18 #include <linux/list.h>
19 #include <linux/config.h>
20 #include <linux/kmod.h>
21 #include <linux/mtd/mtd.h>
22 #include <linux/mtd/partitions.h>
23 #include <linux/mtd/compatmac.h>
25 /* Our partition linked list */
26 static LIST_HEAD(mtd_partitions);
28 /* Our partition node structure */
31 struct mtd_info *master;
34 struct list_head list;
39 * Given a pointer to the MTD object in the mtd_part structure, we can retrieve
40 * the pointer to that structure with this macro.
42 #define PART(x) ((struct mtd_part *)(x))
46 * MTD methods which simply translate the effective address and pass through
47 * to the _real_ device.
50 static int part_read (struct mtd_info *mtd, loff_t from, size_t len,
51 size_t *retlen, u_char *buf)
53 struct mtd_part *part = PART(mtd);
54 if (from >= mtd->size)
56 else if (from + len > mtd->size)
57 len = mtd->size - from;
58 if (part->master->read_ecc == NULL)
59 return part->master->read (part->master, from + part->offset,
62 return part->master->read_ecc (part->master, from + part->offset,
63 len, retlen, buf, NULL, &mtd->oobinfo);
66 static int part_point (struct mtd_info *mtd, loff_t from, size_t len,
67 size_t *retlen, u_char **buf)
69 struct mtd_part *part = PART(mtd);
70 if (from >= mtd->size)
72 else if (from + len > mtd->size)
73 len = mtd->size - from;
74 return part->master->point (part->master, from + part->offset,
77 static void part_unpoint (struct mtd_info *mtd, u_char *addr, loff_t from, size_t len)
79 struct mtd_part *part = PART(mtd);
81 part->master->unpoint (part->master, addr, from + part->offset, len);
85 static int part_read_ecc (struct mtd_info *mtd, loff_t from, size_t len,
86 size_t *retlen, u_char *buf, u_char *eccbuf, struct nand_oobinfo *oobsel)
88 struct mtd_part *part = PART(mtd);
90 oobsel = &mtd->oobinfo;
91 if (from >= mtd->size)
93 else if (from + len > mtd->size)
94 len = mtd->size - from;
95 return part->master->read_ecc (part->master, from + part->offset,
96 len, retlen, buf, eccbuf, oobsel);
99 static int part_read_oob (struct mtd_info *mtd, loff_t from, size_t len,
100 size_t *retlen, u_char *buf)
102 struct mtd_part *part = PART(mtd);
103 if (from >= mtd->size)
105 else if (from + len > mtd->size)
106 len = mtd->size - from;
107 return part->master->read_oob (part->master, from + part->offset,
111 static int part_read_user_prot_reg (struct mtd_info *mtd, loff_t from, size_t len,
112 size_t *retlen, u_char *buf)
114 struct mtd_part *part = PART(mtd);
115 return part->master->read_user_prot_reg (part->master, from,
119 static int part_read_fact_prot_reg (struct mtd_info *mtd, loff_t from, size_t len,
120 size_t *retlen, u_char *buf)
122 struct mtd_part *part = PART(mtd);
123 return part->master->read_fact_prot_reg (part->master, from,
127 static int part_write (struct mtd_info *mtd, loff_t to, size_t len,
128 size_t *retlen, const u_char *buf)
130 struct mtd_part *part = PART(mtd);
131 if (!(mtd->flags & MTD_WRITEABLE))
135 else if (to + len > mtd->size)
136 len = mtd->size - to;
137 if (part->master->write_ecc == NULL)
138 return part->master->write (part->master, to + part->offset,
141 return part->master->write_ecc (part->master, to + part->offset,
142 len, retlen, buf, NULL, &mtd->oobinfo);
146 static int part_write_ecc (struct mtd_info *mtd, loff_t to, size_t len,
147 size_t *retlen, const u_char *buf,
148 u_char *eccbuf, struct nand_oobinfo *oobsel)
150 struct mtd_part *part = PART(mtd);
151 if (!(mtd->flags & MTD_WRITEABLE))
154 oobsel = &mtd->oobinfo;
157 else if (to + len > mtd->size)
158 len = mtd->size - to;
159 return part->master->write_ecc (part->master, to + part->offset,
160 len, retlen, buf, eccbuf, oobsel);
163 static int part_write_oob (struct mtd_info *mtd, loff_t to, size_t len,
164 size_t *retlen, const u_char *buf)
166 struct mtd_part *part = PART(mtd);
167 if (!(mtd->flags & MTD_WRITEABLE))
171 else if (to + len > mtd->size)
172 len = mtd->size - to;
173 return part->master->write_oob (part->master, to + part->offset,
177 static int part_write_user_prot_reg (struct mtd_info *mtd, loff_t from, size_t len,
178 size_t *retlen, u_char *buf)
180 struct mtd_part *part = PART(mtd);
181 return part->master->write_user_prot_reg (part->master, from,
185 static int part_writev (struct mtd_info *mtd, const struct kvec *vecs,
186 unsigned long count, loff_t to, size_t *retlen)
188 struct mtd_part *part = PART(mtd);
189 if (!(mtd->flags & MTD_WRITEABLE))
191 if (part->master->writev_ecc == NULL)
192 return part->master->writev (part->master, vecs, count,
193 to + part->offset, retlen);
195 return part->master->writev_ecc (part->master, vecs, count,
196 to + part->offset, retlen,
197 NULL, &mtd->oobinfo);
200 static int part_readv (struct mtd_info *mtd, struct kvec *vecs,
201 unsigned long count, loff_t from, size_t *retlen)
203 struct mtd_part *part = PART(mtd);
204 if (part->master->readv_ecc == NULL)
205 return part->master->readv (part->master, vecs, count,
206 from + part->offset, retlen);
208 return part->master->readv_ecc (part->master, vecs, count,
209 from + part->offset, retlen,
210 NULL, &mtd->oobinfo);
213 static int part_writev_ecc (struct mtd_info *mtd, const struct kvec *vecs,
214 unsigned long count, loff_t to, size_t *retlen,
215 u_char *eccbuf, struct nand_oobinfo *oobsel)
217 struct mtd_part *part = PART(mtd);
218 if (!(mtd->flags & MTD_WRITEABLE))
221 oobsel = &mtd->oobinfo;
222 return part->master->writev_ecc (part->master, vecs, count,
223 to + part->offset, retlen,
227 static int part_readv_ecc (struct mtd_info *mtd, struct kvec *vecs,
228 unsigned long count, loff_t from, size_t *retlen,
229 u_char *eccbuf, struct nand_oobinfo *oobsel)
231 struct mtd_part *part = PART(mtd);
233 oobsel = &mtd->oobinfo;
234 return part->master->readv_ecc (part->master, vecs, count,
235 from + part->offset, retlen,
239 static int part_erase (struct mtd_info *mtd, struct erase_info *instr)
241 struct mtd_part *part = PART(mtd);
243 if (!(mtd->flags & MTD_WRITEABLE))
245 if (instr->addr >= mtd->size)
247 instr->addr += part->offset;
248 ret = part->master->erase(part->master, instr);
249 if (instr->fail_addr != 0xffffffff)
250 instr->fail_addr -= part->offset;
254 static int part_lock (struct mtd_info *mtd, loff_t ofs, size_t len)
256 struct mtd_part *part = PART(mtd);
257 if ((len + ofs) > mtd->size)
259 return part->master->lock(part->master, ofs + part->offset, len);
262 static int part_unlock (struct mtd_info *mtd, loff_t ofs, size_t len)
264 struct mtd_part *part = PART(mtd);
265 if ((len + ofs) > mtd->size)
267 return part->master->unlock(part->master, ofs + part->offset, len);
270 static void part_sync(struct mtd_info *mtd)
272 struct mtd_part *part = PART(mtd);
273 part->master->sync(part->master);
276 static int part_suspend(struct mtd_info *mtd)
278 struct mtd_part *part = PART(mtd);
279 return part->master->suspend(part->master);
282 static void part_resume(struct mtd_info *mtd)
284 struct mtd_part *part = PART(mtd);
285 part->master->resume(part->master);
288 static int part_block_isbad (struct mtd_info *mtd, loff_t ofs)
290 struct mtd_part *part = PART(mtd);
291 if (ofs >= mtd->size)
294 return part->master->block_isbad(part->master, ofs);
297 static int part_block_markbad (struct mtd_info *mtd, loff_t ofs)
299 struct mtd_part *part = PART(mtd);
300 if (!(mtd->flags & MTD_WRITEABLE))
302 if (ofs >= mtd->size)
305 return part->master->block_markbad(part->master, ofs);
309 * This function unregisters and destroy all slave MTD objects which are
310 * attached to the given master MTD object.
313 int del_mtd_partitions(struct mtd_info *master)
315 struct list_head *node;
316 struct mtd_part *slave;
318 for (node = mtd_partitions.next;
319 node != &mtd_partitions;
321 slave = list_entry(node, struct mtd_part, list);
322 if (slave->master == master) {
323 struct list_head *prev = node->prev;
324 __list_del(prev, node->next);
325 if(slave->registered)
326 del_mtd_device(&slave->mtd);
336 * This function, given a master MTD object and a partition table, creates
337 * and registers slave MTD objects which are bound to the master according to
338 * the partition definitions.
339 * (Q: should we register the master MTD object as well?)
342 int add_mtd_partitions(struct mtd_info *master,
343 const struct mtd_partition *parts,
346 struct mtd_part *slave;
347 u_int32_t cur_offset = 0;
350 printk (KERN_NOTICE "Creating %d MTD partitions on \"%s\":\n", nbparts, master->name);
352 for (i = 0; i < nbparts; i++) {
354 /* allocate the partition structure */
355 slave = kmalloc (sizeof(*slave), GFP_KERNEL);
357 printk ("memory allocation error while creating partitions for \"%s\"\n",
359 del_mtd_partitions(master);
362 memset(slave, 0, sizeof(*slave));
363 list_add(&slave->list, &mtd_partitions);
365 /* set up the MTD object for this partition */
366 slave->mtd.type = master->type;
367 slave->mtd.flags = master->flags & ~parts[i].mask_flags;
368 slave->mtd.size = parts[i].size;
369 slave->mtd.oobblock = master->oobblock;
370 slave->mtd.oobsize = master->oobsize;
371 slave->mtd.ecctype = master->ecctype;
372 slave->mtd.eccsize = master->eccsize;
374 slave->mtd.name = parts[i].name;
375 slave->mtd.bank_size = master->bank_size;
376 slave->mtd.owner = master->owner;
378 slave->mtd.read = part_read;
379 slave->mtd.write = part_write;
381 if(master->point && master->unpoint){
382 slave->mtd.point = part_point;
383 slave->mtd.unpoint = part_unpoint;
386 if (master->read_ecc)
387 slave->mtd.read_ecc = part_read_ecc;
388 if (master->write_ecc)
389 slave->mtd.write_ecc = part_write_ecc;
390 if (master->read_oob)
391 slave->mtd.read_oob = part_read_oob;
392 if (master->write_oob)
393 slave->mtd.write_oob = part_write_oob;
394 if(master->read_user_prot_reg)
395 slave->mtd.read_user_prot_reg = part_read_user_prot_reg;
396 if(master->read_fact_prot_reg)
397 slave->mtd.read_fact_prot_reg = part_read_fact_prot_reg;
398 if(master->write_user_prot_reg)
399 slave->mtd.write_user_prot_reg = part_write_user_prot_reg;
401 slave->mtd.sync = part_sync;
402 if (!i && master->suspend && master->resume) {
403 slave->mtd.suspend = part_suspend;
404 slave->mtd.resume = part_resume;
407 slave->mtd.writev = part_writev;
409 slave->mtd.readv = part_readv;
410 if (master->writev_ecc)
411 slave->mtd.writev_ecc = part_writev_ecc;
412 if (master->readv_ecc)
413 slave->mtd.readv_ecc = part_readv_ecc;
415 slave->mtd.lock = part_lock;
417 slave->mtd.unlock = part_unlock;
418 if (master->block_isbad)
419 slave->mtd.block_isbad = part_block_isbad;
420 if (master->block_markbad)
421 slave->mtd.block_markbad = part_block_markbad;
422 slave->mtd.erase = part_erase;
423 slave->master = master;
424 slave->offset = parts[i].offset;
427 if (slave->offset == MTDPART_OFS_APPEND)
428 slave->offset = cur_offset;
429 if (slave->offset == MTDPART_OFS_NXTBLK) {
430 u_int32_t emask = master->erasesize-1;
431 slave->offset = (cur_offset + emask) & ~emask;
432 if (slave->offset != cur_offset) {
433 printk(KERN_NOTICE "Moving partition %d: "
434 "0x%08x -> 0x%08x\n", i,
435 cur_offset, slave->offset);
438 if (slave->mtd.size == MTDPART_SIZ_FULL)
439 slave->mtd.size = master->size - slave->offset;
440 cur_offset = slave->offset + slave->mtd.size;
442 printk (KERN_NOTICE "0x%08x-0x%08x : \"%s\"\n", slave->offset,
443 slave->offset + slave->mtd.size, slave->mtd.name);
445 /* let's do some sanity checks */
446 if (slave->offset >= master->size) {
447 /* let's register it anyway to preserve ordering */
450 printk ("mtd: partition \"%s\" is out of reach -- disabled\n",
453 if (slave->offset + slave->mtd.size > master->size) {
454 slave->mtd.size = master->size - slave->offset;
455 printk ("mtd: partition \"%s\" extends beyond the end of device \"%s\" -- size truncated to %#x\n",
456 parts[i].name, master->name, slave->mtd.size);
458 if (master->numeraseregions>1) {
459 /* Deal with variable erase size stuff */
461 struct mtd_erase_region_info *regions = master->eraseregions;
463 /* Find the first erase regions which is part of this partition. */
464 for (i=0; i < master->numeraseregions && slave->offset >= regions[i].offset; i++)
467 for (i--; i < master->numeraseregions && slave->offset + slave->mtd.size > regions[i].offset; i++) {
468 if (slave->mtd.erasesize < regions[i].erasesize) {
469 slave->mtd.erasesize = regions[i].erasesize;
473 /* Single erase size */
474 slave->mtd.erasesize = master->erasesize;
477 if ((slave->mtd.flags & MTD_WRITEABLE) &&
478 (slave->offset % slave->mtd.erasesize)) {
479 /* Doesn't start on a boundary of major erase size */
480 /* FIXME: Let it be writable if it is on a boundary of _minor_ erase size though */
481 slave->mtd.flags &= ~MTD_WRITEABLE;
482 printk ("mtd: partition \"%s\" doesn't start on an erase block boundary -- force read-only\n",
485 if ((slave->mtd.flags & MTD_WRITEABLE) &&
486 (slave->mtd.size % slave->mtd.erasesize)) {
487 slave->mtd.flags &= ~MTD_WRITEABLE;
488 printk ("mtd: partition \"%s\" doesn't end on an erase block -- force read-only\n",
492 /* copy oobinfo from master */
493 memcpy(&slave->mtd.oobinfo, &master->oobinfo, sizeof(slave->mtd.oobinfo));
496 { /* store the object pointer (caller may or may not register it */
497 *parts[i].mtdp = &slave->mtd;
498 slave->registered = 0;
502 /* register our partition */
503 add_mtd_device(&slave->mtd);
504 slave->registered = 1;
511 EXPORT_SYMBOL(add_mtd_partitions);
512 EXPORT_SYMBOL(del_mtd_partitions);
514 static spinlock_t part_parser_lock = SPIN_LOCK_UNLOCKED;
515 static LIST_HEAD(part_parsers);
517 struct mtd_part_parser *get_partition_parser(const char *name)
519 struct list_head *this;
521 spin_lock(&part_parser_lock);
523 list_for_each(this, &part_parsers) {
524 struct mtd_part_parser *p = list_entry(this, struct mtd_part_parser, list);
526 if (!strcmp(p->name, name) && try_module_get(p->owner)) {
531 spin_unlock(&part_parser_lock);
536 int register_mtd_parser(struct mtd_part_parser *p)
538 spin_lock(&part_parser_lock);
539 list_add(&p->list, &part_parsers);
540 spin_unlock(&part_parser_lock);
545 int deregister_mtd_parser(struct mtd_part_parser *p)
547 spin_lock(&part_parser_lock);
549 spin_unlock(&part_parser_lock);
553 int parse_mtd_partitions(struct mtd_info *master, const char **types,
554 struct mtd_partition **pparts, unsigned long origin)
556 struct mtd_part_parser *parser;
559 for ( ; ret <= 0 && *types; types++) {
560 parser = get_partition_parser(*types);
562 if (!parser && !request_module("%s", *types))
563 parser = get_partition_parser(*types);
566 printk(KERN_NOTICE "%s partition parsing not available\n",
570 ret = (*parser->parse_fn)(master, pparts, origin);
572 printk(KERN_NOTICE "%d %s partitions found on MTD device %s\n",
573 ret, parser->name, master->name);
575 put_partition_parser(parser);
580 EXPORT_SYMBOL_GPL(parse_mtd_partitions);
581 EXPORT_SYMBOL_GPL(register_mtd_parser);
582 EXPORT_SYMBOL_GPL(deregister_mtd_parser);
584 MODULE_LICENSE("GPL");
585 MODULE_AUTHOR("Nicolas Pitre <nico@cam.org>");
586 MODULE_DESCRIPTION("Generic support for partitioning of MTD devices");