1 /* 1 /*
2 * MTD partitioning layer definitions 2 * MTD partitioning layer definitions
3 * 3 *
4 * (C) 2000 Nicolas Pitre <nico@fluxnic.net> 4 * (C) 2000 Nicolas Pitre <nico@fluxnic.net>
5 * 5 *
6 * This code is GPL 6 * This code is GPL
7 */ 7 */
8 8
9 #ifndef MTD_PARTITIONS_H 9 #ifndef MTD_PARTITIONS_H
10 #define MTD_PARTITIONS_H 10 #define MTD_PARTITIONS_H
11 11
12 #include <linux/types.h> 12 #include <linux/types.h>
13 13
14 14
15 /* 15 /*
16 * Partition definition structure: 16 * Partition definition structure:
17 * 17 *
18 * An array of struct partition is passed alon 18 * An array of struct partition is passed along with a MTD object to
19 * mtd_device_register() to create them. !! 19 * add_mtd_partitions() to create them.
20 * 20 *
21 * For each partition, these fields are availa 21 * For each partition, these fields are available:
22 * name: string that will be used to label the 22 * name: string that will be used to label the partition's MTD device.
23 * types: some partitions can be containers us <<
24 * embedded subpartitions / volumes. E.g. <<
25 * partition that contains at least kerne <<
26 * extra parser is needed that will detec <<
27 * report them to the MTD subsystem. If s <<
28 * of parser names to use when looking fo <<
29 * size: the partition size; if defined as MTD 23 * size: the partition size; if defined as MTDPART_SIZ_FULL, the partition
30 * will extend to the end of the master M 24 * will extend to the end of the master MTD device.
31 * offset: absolute starting position within t 25 * offset: absolute starting position within the master MTD device; if
32 * defined as MTDPART_OFS_APPEND, the par 26 * defined as MTDPART_OFS_APPEND, the partition will start where the
33 * previous one ended; if MTDPART_OFS_NXT !! 27 * previous one ended; if MTDPART_OFS_NXTBLK, at the next erase block.
34 * if MTDPART_OFS_RETAIN, consume as much <<
35 * after the end of partition. <<
36 * mask_flags: contains flags that have to be 28 * mask_flags: contains flags that have to be masked (removed) from the
37 * master MTD flag set for the correspond 29 * master MTD flag set for the corresponding MTD partition.
38 * For example, to force a read-only part 30 * For example, to force a read-only partition, simply adding
39 * MTD_WRITEABLE to the mask_flags will d 31 * MTD_WRITEABLE to the mask_flags will do the trick.
40 * add_flags: contains flags to add to the par <<
41 * 32 *
42 * Note: writeable partitions require their si 33 * Note: writeable partitions require their size and offset be
43 * erasesize aligned (e.g. use MTDPART_OFS_NEX 34 * erasesize aligned (e.g. use MTDPART_OFS_NEXTBLK).
44 */ 35 */
45 36
46 struct mtd_partition { 37 struct mtd_partition {
47 const char *name; /* ide !! 38 char *name; /* identifier string */
48 const char *const *types; /* nam <<
49 uint64_t size; /* par 39 uint64_t size; /* partition size */
50 uint64_t offset; /* off 40 uint64_t offset; /* offset within the master MTD space */
51 uint32_t mask_flags; /* mas 41 uint32_t mask_flags; /* master MTD flags to mask out for this partition */
52 uint32_t add_flags; /* fla !! 42 struct nand_ecclayout *ecclayout; /* out of band layout for this partition (NAND only)*/
53 struct device_node *of_node; <<
54 }; 43 };
55 44
56 #define MTDPART_OFS_RETAIN (-3) <<
57 #define MTDPART_OFS_NXTBLK (-2) 45 #define MTDPART_OFS_NXTBLK (-2)
58 #define MTDPART_OFS_APPEND (-1) 46 #define MTDPART_OFS_APPEND (-1)
59 #define MTDPART_SIZ_FULL (0) 47 #define MTDPART_SIZ_FULL (0)
60 48
61 49
62 struct mtd_info; 50 struct mtd_info;
63 struct device_node; <<
64 <<
65 /** <<
66 * struct mtd_part_parser_data - used to pass <<
67 * @origin: for RedBoot, start address of MTD <<
68 */ <<
69 struct mtd_part_parser_data { <<
70 unsigned long origin; <<
71 }; <<
72 51
>> 52 int add_mtd_partitions(struct mtd_info *, const struct mtd_partition *, int);
>> 53 int del_mtd_partitions(struct mtd_info *);
73 54
74 /* 55 /*
75 * Functions dealing with the various ways of 56 * Functions dealing with the various ways of partitioning the space
76 */ 57 */
77 58
78 struct mtd_part_parser { 59 struct mtd_part_parser {
79 struct list_head list; 60 struct list_head list;
80 struct module *owner; 61 struct module *owner;
81 const char *name; 62 const char *name;
82 const struct of_device_id *of_match_ta !! 63 int (*parse_fn)(struct mtd_info *, struct mtd_partition **, unsigned long);
83 int (*parse_fn)(struct mtd_info *, con <<
84 struct mtd_part_parser <<
85 void (*cleanup)(const struct mtd_parti <<
86 }; 64 };
87 65
88 /* Container for passing around a set of parse !! 66 extern int register_mtd_parser(struct mtd_part_parser *parser);
89 struct mtd_partitions { !! 67 extern int deregister_mtd_parser(struct mtd_part_parser *parser);
90 const struct mtd_partition *parts; !! 68 extern int parse_mtd_partitions(struct mtd_info *master, const char **types,
91 int nr_parts; !! 69 struct mtd_partition **pparts, unsigned long origin);
92 const struct mtd_part_parser *parser; <<
93 }; <<
94 70
95 extern int __register_mtd_parser(struct mtd_pa !! 71 #define put_partition_parser(p) do { module_put((p)->owner); } while(0)
96 struct module <<
97 #define register_mtd_parser(parser) __register <<
98 72
99 extern void deregister_mtd_parser(struct mtd_p !! 73 struct device;
>> 74 struct device_node;
100 75
101 /* !! 76 int __devinit of_mtd_parse_partitions(struct device *dev,
102 * module_mtd_part_parser() - Helper macro for !! 77 struct device_node *node,
103 * do anything special in module init/exit. Ea !! 78 struct mtd_partition **pparts);
104 * once, and calling it replaces module_init() !! 79
105 */ !! 80 #ifdef CONFIG_MTD_PARTITIONS
106 #define module_mtd_part_parser(__mtd_part_pars !! 81 static inline int mtd_has_partitions(void) { return 1; }
107 module_driver(__mtd_part_parser, regis !! 82 #else
108 deregister_mtd_parser) !! 83 static inline int mtd_has_partitions(void) { return 0; }
109 !! 84 #endif
110 int mtd_add_partition(struct mtd_info *master, !! 85
111 long long offset, long l !! 86 #ifdef CONFIG_MTD_CMDLINE_PARTS
112 int mtd_del_partition(struct mtd_info *master, !! 87 static inline int mtd_has_cmdlinepart(void) { return 1; }
113 uint64_t mtd_get_device_size(const struct mtd_ !! 88 #else
>> 89 static inline int mtd_has_cmdlinepart(void) { return 0; }
>> 90 #endif
114 91
115 #endif 92 #endif
116 93
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.