xref: /linux/drivers/mtd/mtdcore.c (revision b43ab901d671e3e3cad425ea5e9a3c74e266dcdd)
1 /*
2  * Core registration and callback routines for MTD
3  * drivers and users.
4  *
5  * Copyright © 1999-2010 David Woodhouse <dwmw2@infradead.org>
6  * Copyright © 2006      Red Hat UK Limited
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
21  *
22  */
23 
24 #include <linux/module.h>
25 #include <linux/kernel.h>
26 #include <linux/ptrace.h>
27 #include <linux/seq_file.h>
28 #include <linux/string.h>
29 #include <linux/timer.h>
30 #include <linux/major.h>
31 #include <linux/fs.h>
32 #include <linux/err.h>
33 #include <linux/ioctl.h>
34 #include <linux/init.h>
35 #include <linux/proc_fs.h>
36 #include <linux/idr.h>
37 #include <linux/backing-dev.h>
38 #include <linux/gfp.h>
39 
40 #include <linux/mtd/mtd.h>
41 #include <linux/mtd/partitions.h>
42 
43 #include "mtdcore.h"
44 /*
45  * backing device capabilities for non-mappable devices (such as NAND flash)
46  * - permits private mappings, copies are taken of the data
47  */
48 static struct backing_dev_info mtd_bdi_unmappable = {
49 	.capabilities	= BDI_CAP_MAP_COPY,
50 };
51 
52 /*
53  * backing device capabilities for R/O mappable devices (such as ROM)
54  * - permits private mappings, copies are taken of the data
55  * - permits non-writable shared mappings
56  */
57 static struct backing_dev_info mtd_bdi_ro_mappable = {
58 	.capabilities	= (BDI_CAP_MAP_COPY | BDI_CAP_MAP_DIRECT |
59 			   BDI_CAP_EXEC_MAP | BDI_CAP_READ_MAP),
60 };
61 
62 /*
63  * backing device capabilities for writable mappable devices (such as RAM)
64  * - permits private mappings, copies are taken of the data
65  * - permits non-writable shared mappings
66  */
67 static struct backing_dev_info mtd_bdi_rw_mappable = {
68 	.capabilities	= (BDI_CAP_MAP_COPY | BDI_CAP_MAP_DIRECT |
69 			   BDI_CAP_EXEC_MAP | BDI_CAP_READ_MAP |
70 			   BDI_CAP_WRITE_MAP),
71 };
72 
73 static int mtd_cls_suspend(struct device *dev, pm_message_t state);
74 static int mtd_cls_resume(struct device *dev);
75 
76 static struct class mtd_class = {
77 	.name = "mtd",
78 	.owner = THIS_MODULE,
79 	.suspend = mtd_cls_suspend,
80 	.resume = mtd_cls_resume,
81 };
82 
83 static DEFINE_IDR(mtd_idr);
84 
85 /* These are exported solely for the purpose of mtd_blkdevs.c. You
86    should not use them for _anything_ else */
87 DEFINE_MUTEX(mtd_table_mutex);
88 EXPORT_SYMBOL_GPL(mtd_table_mutex);
89 
90 struct mtd_info *__mtd_next_device(int i)
91 {
92 	return idr_get_next(&mtd_idr, &i);
93 }
94 EXPORT_SYMBOL_GPL(__mtd_next_device);
95 
96 static LIST_HEAD(mtd_notifiers);
97 
98 
99 #if defined(CONFIG_MTD_CHAR) || defined(CONFIG_MTD_CHAR_MODULE)
100 #define MTD_DEVT(index) MKDEV(MTD_CHAR_MAJOR, (index)*2)
101 #else
102 #define MTD_DEVT(index) 0
103 #endif
104 
105 /* REVISIT once MTD uses the driver model better, whoever allocates
106  * the mtd_info will probably want to use the release() hook...
107  */
108 static void mtd_release(struct device *dev)
109 {
110 	struct mtd_info *mtd = dev_get_drvdata(dev);
111 	dev_t index = MTD_DEVT(mtd->index);
112 
113 	/* remove /dev/mtdXro node if needed */
114 	if (index)
115 		device_destroy(&mtd_class, index + 1);
116 }
117 
118 static int mtd_cls_suspend(struct device *dev, pm_message_t state)
119 {
120 	struct mtd_info *mtd = dev_get_drvdata(dev);
121 
122 	return mtd_suspend(mtd);
123 }
124 
125 static int mtd_cls_resume(struct device *dev)
126 {
127 	struct mtd_info *mtd = dev_get_drvdata(dev);
128 
129 	if (mtd && mtd->resume)
130 		mtd_resume(mtd);
131 	return 0;
132 }
133 
134 static ssize_t mtd_type_show(struct device *dev,
135 		struct device_attribute *attr, char *buf)
136 {
137 	struct mtd_info *mtd = dev_get_drvdata(dev);
138 	char *type;
139 
140 	switch (mtd->type) {
141 	case MTD_ABSENT:
142 		type = "absent";
143 		break;
144 	case MTD_RAM:
145 		type = "ram";
146 		break;
147 	case MTD_ROM:
148 		type = "rom";
149 		break;
150 	case MTD_NORFLASH:
151 		type = "nor";
152 		break;
153 	case MTD_NANDFLASH:
154 		type = "nand";
155 		break;
156 	case MTD_DATAFLASH:
157 		type = "dataflash";
158 		break;
159 	case MTD_UBIVOLUME:
160 		type = "ubi";
161 		break;
162 	default:
163 		type = "unknown";
164 	}
165 
166 	return snprintf(buf, PAGE_SIZE, "%s\n", type);
167 }
168 static DEVICE_ATTR(type, S_IRUGO, mtd_type_show, NULL);
169 
170 static ssize_t mtd_flags_show(struct device *dev,
171 		struct device_attribute *attr, char *buf)
172 {
173 	struct mtd_info *mtd = dev_get_drvdata(dev);
174 
175 	return snprintf(buf, PAGE_SIZE, "0x%lx\n", (unsigned long)mtd->flags);
176 
177 }
178 static DEVICE_ATTR(flags, S_IRUGO, mtd_flags_show, NULL);
179 
180 static ssize_t mtd_size_show(struct device *dev,
181 		struct device_attribute *attr, char *buf)
182 {
183 	struct mtd_info *mtd = dev_get_drvdata(dev);
184 
185 	return snprintf(buf, PAGE_SIZE, "%llu\n",
186 		(unsigned long long)mtd->size);
187 
188 }
189 static DEVICE_ATTR(size, S_IRUGO, mtd_size_show, NULL);
190 
191 static ssize_t mtd_erasesize_show(struct device *dev,
192 		struct device_attribute *attr, char *buf)
193 {
194 	struct mtd_info *mtd = dev_get_drvdata(dev);
195 
196 	return snprintf(buf, PAGE_SIZE, "%lu\n", (unsigned long)mtd->erasesize);
197 
198 }
199 static DEVICE_ATTR(erasesize, S_IRUGO, mtd_erasesize_show, NULL);
200 
201 static ssize_t mtd_writesize_show(struct device *dev,
202 		struct device_attribute *attr, char *buf)
203 {
204 	struct mtd_info *mtd = dev_get_drvdata(dev);
205 
206 	return snprintf(buf, PAGE_SIZE, "%lu\n", (unsigned long)mtd->writesize);
207 
208 }
209 static DEVICE_ATTR(writesize, S_IRUGO, mtd_writesize_show, NULL);
210 
211 static ssize_t mtd_subpagesize_show(struct device *dev,
212 		struct device_attribute *attr, char *buf)
213 {
214 	struct mtd_info *mtd = dev_get_drvdata(dev);
215 	unsigned int subpagesize = mtd->writesize >> mtd->subpage_sft;
216 
217 	return snprintf(buf, PAGE_SIZE, "%u\n", subpagesize);
218 
219 }
220 static DEVICE_ATTR(subpagesize, S_IRUGO, mtd_subpagesize_show, NULL);
221 
222 static ssize_t mtd_oobsize_show(struct device *dev,
223 		struct device_attribute *attr, char *buf)
224 {
225 	struct mtd_info *mtd = dev_get_drvdata(dev);
226 
227 	return snprintf(buf, PAGE_SIZE, "%lu\n", (unsigned long)mtd->oobsize);
228 
229 }
230 static DEVICE_ATTR(oobsize, S_IRUGO, mtd_oobsize_show, NULL);
231 
232 static ssize_t mtd_numeraseregions_show(struct device *dev,
233 		struct device_attribute *attr, char *buf)
234 {
235 	struct mtd_info *mtd = dev_get_drvdata(dev);
236 
237 	return snprintf(buf, PAGE_SIZE, "%u\n", mtd->numeraseregions);
238 
239 }
240 static DEVICE_ATTR(numeraseregions, S_IRUGO, mtd_numeraseregions_show,
241 	NULL);
242 
243 static ssize_t mtd_name_show(struct device *dev,
244 		struct device_attribute *attr, char *buf)
245 {
246 	struct mtd_info *mtd = dev_get_drvdata(dev);
247 
248 	return snprintf(buf, PAGE_SIZE, "%s\n", mtd->name);
249 
250 }
251 static DEVICE_ATTR(name, S_IRUGO, mtd_name_show, NULL);
252 
253 static struct attribute *mtd_attrs[] = {
254 	&dev_attr_type.attr,
255 	&dev_attr_flags.attr,
256 	&dev_attr_size.attr,
257 	&dev_attr_erasesize.attr,
258 	&dev_attr_writesize.attr,
259 	&dev_attr_subpagesize.attr,
260 	&dev_attr_oobsize.attr,
261 	&dev_attr_numeraseregions.attr,
262 	&dev_attr_name.attr,
263 	NULL,
264 };
265 
266 static struct attribute_group mtd_group = {
267 	.attrs		= mtd_attrs,
268 };
269 
270 static const struct attribute_group *mtd_groups[] = {
271 	&mtd_group,
272 	NULL,
273 };
274 
275 static struct device_type mtd_devtype = {
276 	.name		= "mtd",
277 	.groups		= mtd_groups,
278 	.release	= mtd_release,
279 };
280 
281 /**
282  *	add_mtd_device - register an MTD device
283  *	@mtd: pointer to new MTD device info structure
284  *
285  *	Add a device to the list of MTD devices present in the system, and
286  *	notify each currently active MTD 'user' of its arrival. Returns
287  *	zero on success or 1 on failure, which currently will only happen
288  *	if there is insufficient memory or a sysfs error.
289  */
290 
291 int add_mtd_device(struct mtd_info *mtd)
292 {
293 	struct mtd_notifier *not;
294 	int i, error;
295 
296 	if (!mtd->backing_dev_info) {
297 		switch (mtd->type) {
298 		case MTD_RAM:
299 			mtd->backing_dev_info = &mtd_bdi_rw_mappable;
300 			break;
301 		case MTD_ROM:
302 			mtd->backing_dev_info = &mtd_bdi_ro_mappable;
303 			break;
304 		default:
305 			mtd->backing_dev_info = &mtd_bdi_unmappable;
306 			break;
307 		}
308 	}
309 
310 	BUG_ON(mtd->writesize == 0);
311 	mutex_lock(&mtd_table_mutex);
312 
313 	do {
314 		if (!idr_pre_get(&mtd_idr, GFP_KERNEL))
315 			goto fail_locked;
316 		error = idr_get_new(&mtd_idr, mtd, &i);
317 	} while (error == -EAGAIN);
318 
319 	if (error)
320 		goto fail_locked;
321 
322 	mtd->index = i;
323 	mtd->usecount = 0;
324 
325 	if (is_power_of_2(mtd->erasesize))
326 		mtd->erasesize_shift = ffs(mtd->erasesize) - 1;
327 	else
328 		mtd->erasesize_shift = 0;
329 
330 	if (is_power_of_2(mtd->writesize))
331 		mtd->writesize_shift = ffs(mtd->writesize) - 1;
332 	else
333 		mtd->writesize_shift = 0;
334 
335 	mtd->erasesize_mask = (1 << mtd->erasesize_shift) - 1;
336 	mtd->writesize_mask = (1 << mtd->writesize_shift) - 1;
337 
338 	/* Some chips always power up locked. Unlock them now */
339 	if ((mtd->flags & MTD_WRITEABLE) && (mtd->flags & MTD_POWERUP_LOCK)) {
340 		error = mtd_unlock(mtd, 0, mtd->size);
341 		if (error && error != -EOPNOTSUPP)
342 			printk(KERN_WARNING
343 			       "%s: unlock failed, writes may not work\n",
344 			       mtd->name);
345 	}
346 
347 	/* Caller should have set dev.parent to match the
348 	 * physical device.
349 	 */
350 	mtd->dev.type = &mtd_devtype;
351 	mtd->dev.class = &mtd_class;
352 	mtd->dev.devt = MTD_DEVT(i);
353 	dev_set_name(&mtd->dev, "mtd%d", i);
354 	dev_set_drvdata(&mtd->dev, mtd);
355 	if (device_register(&mtd->dev) != 0)
356 		goto fail_added;
357 
358 	if (MTD_DEVT(i))
359 		device_create(&mtd_class, mtd->dev.parent,
360 			      MTD_DEVT(i) + 1,
361 			      NULL, "mtd%dro", i);
362 
363 	pr_debug("mtd: Giving out device %d to %s\n", i, mtd->name);
364 	/* No need to get a refcount on the module containing
365 	   the notifier, since we hold the mtd_table_mutex */
366 	list_for_each_entry(not, &mtd_notifiers, list)
367 		not->add(mtd);
368 
369 	mutex_unlock(&mtd_table_mutex);
370 	/* We _know_ we aren't being removed, because
371 	   our caller is still holding us here. So none
372 	   of this try_ nonsense, and no bitching about it
373 	   either. :) */
374 	__module_get(THIS_MODULE);
375 	return 0;
376 
377 fail_added:
378 	idr_remove(&mtd_idr, i);
379 fail_locked:
380 	mutex_unlock(&mtd_table_mutex);
381 	return 1;
382 }
383 
384 /**
385  *	del_mtd_device - unregister an MTD device
386  *	@mtd: pointer to MTD device info structure
387  *
388  *	Remove a device from the list of MTD devices present in the system,
389  *	and notify each currently active MTD 'user' of its departure.
390  *	Returns zero on success or 1 on failure, which currently will happen
391  *	if the requested device does not appear to be present in the list.
392  */
393 
394 int del_mtd_device(struct mtd_info *mtd)
395 {
396 	int ret;
397 	struct mtd_notifier *not;
398 
399 	mutex_lock(&mtd_table_mutex);
400 
401 	if (idr_find(&mtd_idr, mtd->index) != mtd) {
402 		ret = -ENODEV;
403 		goto out_error;
404 	}
405 
406 	/* No need to get a refcount on the module containing
407 		the notifier, since we hold the mtd_table_mutex */
408 	list_for_each_entry(not, &mtd_notifiers, list)
409 		not->remove(mtd);
410 
411 	if (mtd->usecount) {
412 		printk(KERN_NOTICE "Removing MTD device #%d (%s) with use count %d\n",
413 		       mtd->index, mtd->name, mtd->usecount);
414 		ret = -EBUSY;
415 	} else {
416 		device_unregister(&mtd->dev);
417 
418 		idr_remove(&mtd_idr, mtd->index);
419 
420 		module_put(THIS_MODULE);
421 		ret = 0;
422 	}
423 
424 out_error:
425 	mutex_unlock(&mtd_table_mutex);
426 	return ret;
427 }
428 
429 /**
430  * mtd_device_parse_register - parse partitions and register an MTD device.
431  *
432  * @mtd: the MTD device to register
433  * @types: the list of MTD partition probes to try, see
434  *         'parse_mtd_partitions()' for more information
435  * @parser_data: MTD partition parser-specific data
436  * @parts: fallback partition information to register, if parsing fails;
437  *         only valid if %nr_parts > %0
438  * @nr_parts: the number of partitions in parts, if zero then the full
439  *            MTD device is registered if no partition info is found
440  *
441  * This function aggregates MTD partitions parsing (done by
442  * 'parse_mtd_partitions()') and MTD device and partitions registering. It
443  * basically follows the most common pattern found in many MTD drivers:
444  *
445  * * It first tries to probe partitions on MTD device @mtd using parsers
446  *   specified in @types (if @types is %NULL, then the default list of parsers
447  *   is used, see 'parse_mtd_partitions()' for more information). If none are
448  *   found this functions tries to fallback to information specified in
449  *   @parts/@nr_parts.
450  * * If any partitioning info was found, this function registers the found
451  *   partitions.
452  * * If no partitions were found this function just registers the MTD device
453  *   @mtd and exits.
454  *
455  * Returns zero in case of success and a negative error code in case of failure.
456  */
457 int mtd_device_parse_register(struct mtd_info *mtd, const char **types,
458 			      struct mtd_part_parser_data *parser_data,
459 			      const struct mtd_partition *parts,
460 			      int nr_parts)
461 {
462 	int err;
463 	struct mtd_partition *real_parts;
464 
465 	err = parse_mtd_partitions(mtd, types, &real_parts, parser_data);
466 	if (err <= 0 && nr_parts && parts) {
467 		real_parts = kmemdup(parts, sizeof(*parts) * nr_parts,
468 				     GFP_KERNEL);
469 		if (!real_parts)
470 			err = -ENOMEM;
471 		else
472 			err = nr_parts;
473 	}
474 
475 	if (err > 0) {
476 		err = add_mtd_partitions(mtd, real_parts, err);
477 		kfree(real_parts);
478 	} else if (err == 0) {
479 		err = add_mtd_device(mtd);
480 		if (err == 1)
481 			err = -ENODEV;
482 	}
483 
484 	return err;
485 }
486 EXPORT_SYMBOL_GPL(mtd_device_parse_register);
487 
488 /**
489  * mtd_device_unregister - unregister an existing MTD device.
490  *
491  * @master: the MTD device to unregister.  This will unregister both the master
492  *          and any partitions if registered.
493  */
494 int mtd_device_unregister(struct mtd_info *master)
495 {
496 	int err;
497 
498 	err = del_mtd_partitions(master);
499 	if (err)
500 		return err;
501 
502 	if (!device_is_registered(&master->dev))
503 		return 0;
504 
505 	return del_mtd_device(master);
506 }
507 EXPORT_SYMBOL_GPL(mtd_device_unregister);
508 
509 /**
510  *	register_mtd_user - register a 'user' of MTD devices.
511  *	@new: pointer to notifier info structure
512  *
513  *	Registers a pair of callbacks function to be called upon addition
514  *	or removal of MTD devices. Causes the 'add' callback to be immediately
515  *	invoked for each MTD device currently present in the system.
516  */
517 void register_mtd_user (struct mtd_notifier *new)
518 {
519 	struct mtd_info *mtd;
520 
521 	mutex_lock(&mtd_table_mutex);
522 
523 	list_add(&new->list, &mtd_notifiers);
524 
525 	__module_get(THIS_MODULE);
526 
527 	mtd_for_each_device(mtd)
528 		new->add(mtd);
529 
530 	mutex_unlock(&mtd_table_mutex);
531 }
532 EXPORT_SYMBOL_GPL(register_mtd_user);
533 
534 /**
535  *	unregister_mtd_user - unregister a 'user' of MTD devices.
536  *	@old: pointer to notifier info structure
537  *
538  *	Removes a callback function pair from the list of 'users' to be
539  *	notified upon addition or removal of MTD devices. Causes the
540  *	'remove' callback to be immediately invoked for each MTD device
541  *	currently present in the system.
542  */
543 int unregister_mtd_user (struct mtd_notifier *old)
544 {
545 	struct mtd_info *mtd;
546 
547 	mutex_lock(&mtd_table_mutex);
548 
549 	module_put(THIS_MODULE);
550 
551 	mtd_for_each_device(mtd)
552 		old->remove(mtd);
553 
554 	list_del(&old->list);
555 	mutex_unlock(&mtd_table_mutex);
556 	return 0;
557 }
558 EXPORT_SYMBOL_GPL(unregister_mtd_user);
559 
560 /**
561  *	get_mtd_device - obtain a validated handle for an MTD device
562  *	@mtd: last known address of the required MTD device
563  *	@num: internal device number of the required MTD device
564  *
565  *	Given a number and NULL address, return the num'th entry in the device
566  *	table, if any.	Given an address and num == -1, search the device table
567  *	for a device with that address and return if it's still present. Given
568  *	both, return the num'th driver only if its address matches. Return
569  *	error code if not.
570  */
571 struct mtd_info *get_mtd_device(struct mtd_info *mtd, int num)
572 {
573 	struct mtd_info *ret = NULL, *other;
574 	int err = -ENODEV;
575 
576 	mutex_lock(&mtd_table_mutex);
577 
578 	if (num == -1) {
579 		mtd_for_each_device(other) {
580 			if (other == mtd) {
581 				ret = mtd;
582 				break;
583 			}
584 		}
585 	} else if (num >= 0) {
586 		ret = idr_find(&mtd_idr, num);
587 		if (mtd && mtd != ret)
588 			ret = NULL;
589 	}
590 
591 	if (!ret) {
592 		ret = ERR_PTR(err);
593 		goto out;
594 	}
595 
596 	err = __get_mtd_device(ret);
597 	if (err)
598 		ret = ERR_PTR(err);
599 out:
600 	mutex_unlock(&mtd_table_mutex);
601 	return ret;
602 }
603 EXPORT_SYMBOL_GPL(get_mtd_device);
604 
605 
606 int __get_mtd_device(struct mtd_info *mtd)
607 {
608 	int err;
609 
610 	if (!try_module_get(mtd->owner))
611 		return -ENODEV;
612 
613 	if (mtd->get_device) {
614 		err = mtd->get_device(mtd);
615 
616 		if (err) {
617 			module_put(mtd->owner);
618 			return err;
619 		}
620 	}
621 	mtd->usecount++;
622 	return 0;
623 }
624 EXPORT_SYMBOL_GPL(__get_mtd_device);
625 
626 /**
627  *	get_mtd_device_nm - obtain a validated handle for an MTD device by
628  *	device name
629  *	@name: MTD device name to open
630  *
631  * 	This function returns MTD device description structure in case of
632  * 	success and an error code in case of failure.
633  */
634 struct mtd_info *get_mtd_device_nm(const char *name)
635 {
636 	int err = -ENODEV;
637 	struct mtd_info *mtd = NULL, *other;
638 
639 	mutex_lock(&mtd_table_mutex);
640 
641 	mtd_for_each_device(other) {
642 		if (!strcmp(name, other->name)) {
643 			mtd = other;
644 			break;
645 		}
646 	}
647 
648 	if (!mtd)
649 		goto out_unlock;
650 
651 	err = __get_mtd_device(mtd);
652 	if (err)
653 		goto out_unlock;
654 
655 	mutex_unlock(&mtd_table_mutex);
656 	return mtd;
657 
658 out_unlock:
659 	mutex_unlock(&mtd_table_mutex);
660 	return ERR_PTR(err);
661 }
662 EXPORT_SYMBOL_GPL(get_mtd_device_nm);
663 
664 void put_mtd_device(struct mtd_info *mtd)
665 {
666 	mutex_lock(&mtd_table_mutex);
667 	__put_mtd_device(mtd);
668 	mutex_unlock(&mtd_table_mutex);
669 
670 }
671 EXPORT_SYMBOL_GPL(put_mtd_device);
672 
673 void __put_mtd_device(struct mtd_info *mtd)
674 {
675 	--mtd->usecount;
676 	BUG_ON(mtd->usecount < 0);
677 
678 	if (mtd->put_device)
679 		mtd->put_device(mtd);
680 
681 	module_put(mtd->owner);
682 }
683 EXPORT_SYMBOL_GPL(__put_mtd_device);
684 
685 /*
686  * default_mtd_writev - the default writev method
687  * @mtd: mtd device description object pointer
688  * @vecs: the vectors to write
689  * @count: count of vectors in @vecs
690  * @to: the MTD device offset to write to
691  * @retlen: on exit contains the count of bytes written to the MTD device.
692  *
693  * This function returns zero in case of success and a negative error code in
694  * case of failure.
695  */
696 static int default_mtd_writev(struct mtd_info *mtd, const struct kvec *vecs,
697 			      unsigned long count, loff_t to, size_t *retlen)
698 {
699 	unsigned long i;
700 	size_t totlen = 0, thislen;
701 	int ret = 0;
702 
703 	for (i = 0; i < count; i++) {
704 		if (!vecs[i].iov_len)
705 			continue;
706 		ret = mtd_write(mtd, to, vecs[i].iov_len, &thislen,
707 				vecs[i].iov_base);
708 		totlen += thislen;
709 		if (ret || thislen != vecs[i].iov_len)
710 			break;
711 		to += vecs[i].iov_len;
712 	}
713 	*retlen = totlen;
714 	return ret;
715 }
716 
717 /*
718  * mtd_writev - the vector-based MTD write method
719  * @mtd: mtd device description object pointer
720  * @vecs: the vectors to write
721  * @count: count of vectors in @vecs
722  * @to: the MTD device offset to write to
723  * @retlen: on exit contains the count of bytes written to the MTD device.
724  *
725  * This function returns zero in case of success and a negative error code in
726  * case of failure.
727  */
728 int mtd_writev(struct mtd_info *mtd, const struct kvec *vecs,
729 	       unsigned long count, loff_t to, size_t *retlen)
730 {
731 	*retlen = 0;
732 	if (!mtd->writev)
733 		return default_mtd_writev(mtd, vecs, count, to, retlen);
734 	return mtd->writev(mtd, vecs, count, to, retlen);
735 }
736 EXPORT_SYMBOL_GPL(mtd_writev);
737 
738 /**
739  * mtd_kmalloc_up_to - allocate a contiguous buffer up to the specified size
740  * @mtd: mtd device description object pointer
741  * @size: a pointer to the ideal or maximum size of the allocation, points
742  *        to the actual allocation size on success.
743  *
744  * This routine attempts to allocate a contiguous kernel buffer up to
745  * the specified size, backing off the size of the request exponentially
746  * until the request succeeds or until the allocation size falls below
747  * the system page size. This attempts to make sure it does not adversely
748  * impact system performance, so when allocating more than one page, we
749  * ask the memory allocator to avoid re-trying, swapping, writing back
750  * or performing I/O.
751  *
752  * Note, this function also makes sure that the allocated buffer is aligned to
753  * the MTD device's min. I/O unit, i.e. the "mtd->writesize" value.
754  *
755  * This is called, for example by mtd_{read,write} and jffs2_scan_medium,
756  * to handle smaller (i.e. degraded) buffer allocations under low- or
757  * fragmented-memory situations where such reduced allocations, from a
758  * requested ideal, are allowed.
759  *
760  * Returns a pointer to the allocated buffer on success; otherwise, NULL.
761  */
762 void *mtd_kmalloc_up_to(const struct mtd_info *mtd, size_t *size)
763 {
764 	gfp_t flags = __GFP_NOWARN | __GFP_WAIT |
765 		       __GFP_NORETRY | __GFP_NO_KSWAPD;
766 	size_t min_alloc = max_t(size_t, mtd->writesize, PAGE_SIZE);
767 	void *kbuf;
768 
769 	*size = min_t(size_t, *size, KMALLOC_MAX_SIZE);
770 
771 	while (*size > min_alloc) {
772 		kbuf = kmalloc(*size, flags);
773 		if (kbuf)
774 			return kbuf;
775 
776 		*size >>= 1;
777 		*size = ALIGN(*size, mtd->writesize);
778 	}
779 
780 	/*
781 	 * For the last resort allocation allow 'kmalloc()' to do all sorts of
782 	 * things (write-back, dropping caches, etc) by using GFP_KERNEL.
783 	 */
784 	return kmalloc(*size, GFP_KERNEL);
785 }
786 EXPORT_SYMBOL_GPL(mtd_kmalloc_up_to);
787 
788 #ifdef CONFIG_PROC_FS
789 
790 /*====================================================================*/
791 /* Support for /proc/mtd */
792 
793 static struct proc_dir_entry *proc_mtd;
794 
795 static int mtd_proc_show(struct seq_file *m, void *v)
796 {
797 	struct mtd_info *mtd;
798 
799 	seq_puts(m, "dev:    size   erasesize  name\n");
800 	mutex_lock(&mtd_table_mutex);
801 	mtd_for_each_device(mtd) {
802 		seq_printf(m, "mtd%d: %8.8llx %8.8x \"%s\"\n",
803 			   mtd->index, (unsigned long long)mtd->size,
804 			   mtd->erasesize, mtd->name);
805 	}
806 	mutex_unlock(&mtd_table_mutex);
807 	return 0;
808 }
809 
810 static int mtd_proc_open(struct inode *inode, struct file *file)
811 {
812 	return single_open(file, mtd_proc_show, NULL);
813 }
814 
815 static const struct file_operations mtd_proc_ops = {
816 	.open		= mtd_proc_open,
817 	.read		= seq_read,
818 	.llseek		= seq_lseek,
819 	.release	= single_release,
820 };
821 #endif /* CONFIG_PROC_FS */
822 
823 /*====================================================================*/
824 /* Init code */
825 
826 static int __init mtd_bdi_init(struct backing_dev_info *bdi, const char *name)
827 {
828 	int ret;
829 
830 	ret = bdi_init(bdi);
831 	if (!ret)
832 		ret = bdi_register(bdi, NULL, name);
833 
834 	if (ret)
835 		bdi_destroy(bdi);
836 
837 	return ret;
838 }
839 
840 static int __init init_mtd(void)
841 {
842 	int ret;
843 
844 	ret = class_register(&mtd_class);
845 	if (ret)
846 		goto err_reg;
847 
848 	ret = mtd_bdi_init(&mtd_bdi_unmappable, "mtd-unmap");
849 	if (ret)
850 		goto err_bdi1;
851 
852 	ret = mtd_bdi_init(&mtd_bdi_ro_mappable, "mtd-romap");
853 	if (ret)
854 		goto err_bdi2;
855 
856 	ret = mtd_bdi_init(&mtd_bdi_rw_mappable, "mtd-rwmap");
857 	if (ret)
858 		goto err_bdi3;
859 
860 #ifdef CONFIG_PROC_FS
861 	proc_mtd = proc_create("mtd", 0, NULL, &mtd_proc_ops);
862 #endif /* CONFIG_PROC_FS */
863 	return 0;
864 
865 err_bdi3:
866 	bdi_destroy(&mtd_bdi_ro_mappable);
867 err_bdi2:
868 	bdi_destroy(&mtd_bdi_unmappable);
869 err_bdi1:
870 	class_unregister(&mtd_class);
871 err_reg:
872 	pr_err("Error registering mtd class or bdi: %d\n", ret);
873 	return ret;
874 }
875 
876 static void __exit cleanup_mtd(void)
877 {
878 #ifdef CONFIG_PROC_FS
879 	if (proc_mtd)
880 		remove_proc_entry( "mtd", NULL);
881 #endif /* CONFIG_PROC_FS */
882 	class_unregister(&mtd_class);
883 	bdi_destroy(&mtd_bdi_unmappable);
884 	bdi_destroy(&mtd_bdi_ro_mappable);
885 	bdi_destroy(&mtd_bdi_rw_mappable);
886 }
887 
888 module_init(init_mtd);
889 module_exit(cleanup_mtd);
890 
891 MODULE_LICENSE("GPL");
892 MODULE_AUTHOR("David Woodhouse <dwmw2@infradead.org>");
893 MODULE_DESCRIPTION("Core MTD registration and access routines");
894