Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 1 | /* |
| 2 | * MTD partitioning layer definitions |
| 3 | * |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 4 | * (C) 2000 Nicolas Pitre <nico@fluxnic.net> |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 5 | * |
| 6 | * This code is GPL |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 7 | */ |
| 8 | |
| 9 | #ifndef MTD_PARTITIONS_H |
| 10 | #define MTD_PARTITIONS_H |
| 11 | |
| 12 | #include <linux/types.h> |
| 13 | |
| 14 | |
| 15 | /* |
| 16 | * Partition definition structure: |
| 17 | * |
| 18 | * An array of struct partition is passed along with a MTD object to |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 19 | * mtd_device_register() to create them. |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 20 | * |
| 21 | * For each partition, these fields are available: |
| 22 | * name: string that will be used to label the partition's MTD device. |
| 23 | * size: the partition size; if defined as MTDPART_SIZ_FULL, the partition |
| 24 | * will extend to the end of the master MTD device. |
| 25 | * offset: absolute starting position within the master MTD device; if |
| 26 | * defined as MTDPART_OFS_APPEND, the partition will start where the |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 27 | * previous one ended; if MTDPART_OFS_NXTBLK, at the next erase block; |
| 28 | * if MTDPART_OFS_RETAIN, consume as much as possible, leaving size |
| 29 | * after the end of partition. |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 30 | * mask_flags: contains flags that have to be masked (removed) from the |
| 31 | * master MTD flag set for the corresponding MTD partition. |
| 32 | * For example, to force a read-only partition, simply adding |
| 33 | * MTD_WRITEABLE to the mask_flags will do the trick. |
| 34 | * |
| 35 | * Note: writeable partitions require their size and offset be |
| 36 | * erasesize aligned (e.g. use MTDPART_OFS_NEXTBLK). |
| 37 | */ |
| 38 | |
| 39 | struct mtd_partition { |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 40 | const char *name; /* identifier string */ |
Sandeep Paulraj | eab580c | 2009-10-30 13:51:23 -0400 | [diff] [blame] | 41 | uint64_t size; /* partition size */ |
| 42 | uint64_t offset; /* offset within the master MTD space */ |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 43 | uint32_t mask_flags; /* master MTD flags to mask out for this partition */ |
| 44 | struct nand_ecclayout *ecclayout; /* out of band layout for this partition (NAND only) */ |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 45 | }; |
| 46 | |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 47 | #define MTDPART_OFS_RETAIN (-3) |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 48 | #define MTDPART_OFS_NXTBLK (-2) |
| 49 | #define MTDPART_OFS_APPEND (-1) |
| 50 | #define MTDPART_SIZ_FULL (0) |
| 51 | |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 52 | |
| 53 | struct mtd_info; |
| 54 | struct device_node; |
| 55 | |
| 56 | #ifndef __UBOOT__ |
| 57 | /** |
| 58 | * struct mtd_part_parser_data - used to pass data to MTD partition parsers. |
| 59 | * @origin: for RedBoot, start address of MTD device |
| 60 | * @of_node: for OF parsers, device node containing partitioning information |
| 61 | */ |
| 62 | struct mtd_part_parser_data { |
| 63 | unsigned long origin; |
| 64 | struct device_node *of_node; |
| 65 | }; |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 66 | |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 67 | |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 68 | /* |
| 69 | * Functions dealing with the various ways of partitioning the space |
| 70 | */ |
| 71 | |
| 72 | struct mtd_part_parser { |
| 73 | struct list_head list; |
| 74 | struct module *owner; |
| 75 | const char *name; |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 76 | int (*parse_fn)(struct mtd_info *, struct mtd_partition **, |
| 77 | struct mtd_part_parser_data *); |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 78 | }; |
| 79 | |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 80 | extern void register_mtd_parser(struct mtd_part_parser *parser); |
| 81 | extern void deregister_mtd_parser(struct mtd_part_parser *parser); |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 82 | #endif |
| 83 | |
Heiko Schocher | f5895d1 | 2014-06-24 10:10:04 +0200 | [diff] [blame] | 84 | int mtd_add_partition(struct mtd_info *master, const char *name, |
| 85 | long long offset, long long length); |
| 86 | int mtd_del_partition(struct mtd_info *master, int partno); |
| 87 | uint64_t mtd_get_device_size(const struct mtd_info *mtd); |
| 88 | |
Miquel Raynal | 6f381d5 | 2018-09-29 12:58:25 +0200 | [diff] [blame] | 89 | #if defined(CONFIG_MTD_PARTITIONS) |
| 90 | int mtd_parse_partitions(struct mtd_info *parent, const char **_mtdparts, |
| 91 | struct mtd_partition **_parts, int *_nparts); |
| 92 | void mtd_free_parsed_partitions(struct mtd_partition *parts, |
| 93 | unsigned int nparts); |
| 94 | #else |
| 95 | static inline int |
| 96 | mtd_parse_partitions(struct mtd_info *parent, const char **_mtdparts, |
| 97 | struct mtd_partition **_parts, int *_nparts) |
| 98 | { |
| 99 | *_nparts = 0; |
| 100 | |
| 101 | return 0; |
| 102 | } |
| 103 | static inline void |
| 104 | mtd_free_parsed_partitions(struct mtd_partition *parts, unsigned int nparts) |
| 105 | { |
| 106 | return; |
| 107 | } |
| 108 | #endif /* defined(MTD_PARTITIONS) */ |
| 109 | |
Kyungmin Park | ad7ae36 | 2008-11-19 16:32:36 +0100 | [diff] [blame] | 110 | #endif |