x86/mm/pat: Don't report PAT on CPUs that don't support it
[linux/fpc-iii.git] / drivers / mtd / ubi / gluebi.c
blob1cb287ec32adbb486c3289c23a89191e7be48221
1 /*
2 * Copyright (c) International Business Machines Corp., 2006
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
12 * the GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18 * Author: Artem Bityutskiy (Битюцкий Артём), Joern Engel
22 * This is a small driver which implements fake MTD devices on top of UBI
23 * volumes. This sounds strange, but it is in fact quite useful to make
24 * MTD-oriented software (including all the legacy software) work on top of
25 * UBI.
27 * Gluebi emulates MTD devices of "MTD_UBIVOLUME" type. Their minimal I/O unit
28 * size (@mtd->writesize) is equivalent to the UBI minimal I/O unit. The
29 * eraseblock size is equivalent to the logical eraseblock size of the volume.
32 #include <linux/err.h>
33 #include <linux/list.h>
34 #include <linux/slab.h>
35 #include <linux/sched.h>
36 #include <linux/math64.h>
37 #include <linux/module.h>
38 #include <linux/mutex.h>
39 #include <linux/mtd/ubi.h>
40 #include <linux/mtd/mtd.h>
41 #include "ubi-media.h"
43 #define err_msg(fmt, ...) \
44 pr_err("gluebi (pid %d): %s: " fmt "\n", \
45 current->pid, __func__, ##__VA_ARGS__)
47 /**
48 * struct gluebi_device - a gluebi device description data structure.
49 * @mtd: emulated MTD device description object
50 * @refcnt: gluebi device reference count
51 * @desc: UBI volume descriptor
52 * @ubi_num: UBI device number this gluebi device works on
53 * @vol_id: ID of UBI volume this gluebi device works on
54 * @list: link in a list of gluebi devices
56 struct gluebi_device {
57 struct mtd_info mtd;
58 int refcnt;
59 struct ubi_volume_desc *desc;
60 int ubi_num;
61 int vol_id;
62 struct list_head list;
65 /* List of all gluebi devices */
66 static LIST_HEAD(gluebi_devices);
67 static DEFINE_MUTEX(devices_mutex);
69 /**
70 * find_gluebi_nolock - find a gluebi device.
71 * @ubi_num: UBI device number
72 * @vol_id: volume ID
74 * This function seraches for gluebi device corresponding to UBI device
75 * @ubi_num and UBI volume @vol_id. Returns the gluebi device description
76 * object in case of success and %NULL in case of failure. The caller has to
77 * have the &devices_mutex locked.
79 static struct gluebi_device *find_gluebi_nolock(int ubi_num, int vol_id)
81 struct gluebi_device *gluebi;
83 list_for_each_entry(gluebi, &gluebi_devices, list)
84 if (gluebi->ubi_num == ubi_num && gluebi->vol_id == vol_id)
85 return gluebi;
86 return NULL;
89 /**
90 * gluebi_get_device - get MTD device reference.
91 * @mtd: the MTD device description object
93 * This function is called every time the MTD device is being opened and
94 * implements the MTD get_device() operation. Returns zero in case of success
95 * and a negative error code in case of failure.
97 static int gluebi_get_device(struct mtd_info *mtd)
99 struct gluebi_device *gluebi;
100 int ubi_mode = UBI_READONLY;
102 if (mtd->flags & MTD_WRITEABLE)
103 ubi_mode = UBI_READWRITE;
105 gluebi = container_of(mtd, struct gluebi_device, mtd);
106 mutex_lock(&devices_mutex);
107 if (gluebi->refcnt > 0) {
109 * The MTD device is already referenced and this is just one
110 * more reference. MTD allows many users to open the same
111 * volume simultaneously and do not distinguish between
112 * readers/writers/exclusive/meta openers as UBI does. So we do
113 * not open the UBI volume again - just increase the reference
114 * counter and return.
116 gluebi->refcnt += 1;
117 mutex_unlock(&devices_mutex);
118 return 0;
122 * This is the first reference to this UBI volume via the MTD device
123 * interface. Open the corresponding volume in read-write mode.
125 gluebi->desc = ubi_open_volume(gluebi->ubi_num, gluebi->vol_id,
126 ubi_mode);
127 if (IS_ERR(gluebi->desc)) {
128 mutex_unlock(&devices_mutex);
129 return PTR_ERR(gluebi->desc);
131 gluebi->refcnt += 1;
132 mutex_unlock(&devices_mutex);
133 return 0;
137 * gluebi_put_device - put MTD device reference.
138 * @mtd: the MTD device description object
140 * This function is called every time the MTD device is being put. Returns
141 * zero in case of success and a negative error code in case of failure.
143 static void gluebi_put_device(struct mtd_info *mtd)
145 struct gluebi_device *gluebi;
147 gluebi = container_of(mtd, struct gluebi_device, mtd);
148 mutex_lock(&devices_mutex);
149 gluebi->refcnt -= 1;
150 if (gluebi->refcnt == 0)
151 ubi_close_volume(gluebi->desc);
152 mutex_unlock(&devices_mutex);
156 * gluebi_read - read operation of emulated MTD devices.
157 * @mtd: MTD device description object
158 * @from: absolute offset from where to read
159 * @len: how many bytes to read
160 * @retlen: count of read bytes is returned here
161 * @buf: buffer to store the read data
163 * This function returns zero in case of success and a negative error code in
164 * case of failure.
166 static int gluebi_read(struct mtd_info *mtd, loff_t from, size_t len,
167 size_t *retlen, unsigned char *buf)
169 int err = 0, lnum, offs, bytes_left;
170 struct gluebi_device *gluebi;
172 gluebi = container_of(mtd, struct gluebi_device, mtd);
173 lnum = div_u64_rem(from, mtd->erasesize, &offs);
174 bytes_left = len;
175 while (bytes_left) {
176 size_t to_read = mtd->erasesize - offs;
178 if (to_read > bytes_left)
179 to_read = bytes_left;
181 err = ubi_read(gluebi->desc, lnum, buf, offs, to_read);
182 if (err)
183 break;
185 lnum += 1;
186 offs = 0;
187 bytes_left -= to_read;
188 buf += to_read;
191 *retlen = len - bytes_left;
192 return err;
196 * gluebi_write - write operation of emulated MTD devices.
197 * @mtd: MTD device description object
198 * @to: absolute offset where to write
199 * @len: how many bytes to write
200 * @retlen: count of written bytes is returned here
201 * @buf: buffer with data to write
203 * This function returns zero in case of success and a negative error code in
204 * case of failure.
206 static int gluebi_write(struct mtd_info *mtd, loff_t to, size_t len,
207 size_t *retlen, const u_char *buf)
209 int err = 0, lnum, offs, bytes_left;
210 struct gluebi_device *gluebi;
212 gluebi = container_of(mtd, struct gluebi_device, mtd);
213 lnum = div_u64_rem(to, mtd->erasesize, &offs);
215 if (len % mtd->writesize || offs % mtd->writesize)
216 return -EINVAL;
218 bytes_left = len;
219 while (bytes_left) {
220 size_t to_write = mtd->erasesize - offs;
222 if (to_write > bytes_left)
223 to_write = bytes_left;
225 err = ubi_leb_write(gluebi->desc, lnum, buf, offs, to_write);
226 if (err)
227 break;
229 lnum += 1;
230 offs = 0;
231 bytes_left -= to_write;
232 buf += to_write;
235 *retlen = len - bytes_left;
236 return err;
240 * gluebi_erase - erase operation of emulated MTD devices.
241 * @mtd: the MTD device description object
242 * @instr: the erase operation description
244 * This function calls the erase callback when finishes. Returns zero in case
245 * of success and a negative error code in case of failure.
247 static int gluebi_erase(struct mtd_info *mtd, struct erase_info *instr)
249 int err, i, lnum, count;
250 struct gluebi_device *gluebi;
252 if (mtd_mod_by_ws(instr->addr, mtd) || mtd_mod_by_ws(instr->len, mtd))
253 return -EINVAL;
255 lnum = mtd_div_by_eb(instr->addr, mtd);
256 count = mtd_div_by_eb(instr->len, mtd);
257 gluebi = container_of(mtd, struct gluebi_device, mtd);
259 for (i = 0; i < count - 1; i++) {
260 err = ubi_leb_unmap(gluebi->desc, lnum + i);
261 if (err)
262 goto out_err;
265 * MTD erase operations are synchronous, so we have to make sure the
266 * physical eraseblock is wiped out.
268 * Thus, perform leb_erase instead of leb_unmap operation - leb_erase
269 * will wait for the end of operations
271 err = ubi_leb_erase(gluebi->desc, lnum + i);
272 if (err)
273 goto out_err;
275 instr->state = MTD_ERASE_DONE;
276 mtd_erase_callback(instr);
277 return 0;
279 out_err:
280 instr->state = MTD_ERASE_FAILED;
281 instr->fail_addr = (long long)lnum * mtd->erasesize;
282 return err;
286 * gluebi_create - create a gluebi device for an UBI volume.
287 * @di: UBI device description object
288 * @vi: UBI volume description object
290 * This function is called when a new UBI volume is created in order to create
291 * corresponding fake MTD device. Returns zero in case of success and a
292 * negative error code in case of failure.
294 static int gluebi_create(struct ubi_device_info *di,
295 struct ubi_volume_info *vi)
297 struct gluebi_device *gluebi, *g;
298 struct mtd_info *mtd;
300 gluebi = kzalloc(sizeof(struct gluebi_device), GFP_KERNEL);
301 if (!gluebi)
302 return -ENOMEM;
304 mtd = &gluebi->mtd;
305 mtd->name = kmemdup(vi->name, vi->name_len + 1, GFP_KERNEL);
306 if (!mtd->name) {
307 kfree(gluebi);
308 return -ENOMEM;
311 gluebi->vol_id = vi->vol_id;
312 gluebi->ubi_num = vi->ubi_num;
313 mtd->type = MTD_UBIVOLUME;
314 if (!di->ro_mode)
315 mtd->flags = MTD_WRITEABLE;
316 mtd->owner = THIS_MODULE;
317 mtd->writesize = di->min_io_size;
318 mtd->erasesize = vi->usable_leb_size;
319 mtd->_read = gluebi_read;
320 mtd->_write = gluebi_write;
321 mtd->_erase = gluebi_erase;
322 mtd->_get_device = gluebi_get_device;
323 mtd->_put_device = gluebi_put_device;
326 * In case of dynamic a volume, MTD device size is just volume size. In
327 * case of a static volume the size is equivalent to the amount of data
328 * bytes.
330 if (vi->vol_type == UBI_DYNAMIC_VOLUME)
331 mtd->size = (unsigned long long)vi->usable_leb_size * vi->size;
332 else
333 mtd->size = vi->used_bytes;
335 /* Just a sanity check - make sure this gluebi device does not exist */
336 mutex_lock(&devices_mutex);
337 g = find_gluebi_nolock(vi->ubi_num, vi->vol_id);
338 if (g)
339 err_msg("gluebi MTD device %d form UBI device %d volume %d already exists",
340 g->mtd.index, vi->ubi_num, vi->vol_id);
341 mutex_unlock(&devices_mutex);
343 if (mtd_device_register(mtd, NULL, 0)) {
344 err_msg("cannot add MTD device");
345 kfree(mtd->name);
346 kfree(gluebi);
347 return -ENFILE;
350 mutex_lock(&devices_mutex);
351 list_add_tail(&gluebi->list, &gluebi_devices);
352 mutex_unlock(&devices_mutex);
353 return 0;
357 * gluebi_remove - remove a gluebi device.
358 * @vi: UBI volume description object
360 * This function is called when an UBI volume is removed and it removes
361 * corresponding fake MTD device. Returns zero in case of success and a
362 * negative error code in case of failure.
364 static int gluebi_remove(struct ubi_volume_info *vi)
366 int err = 0;
367 struct mtd_info *mtd;
368 struct gluebi_device *gluebi;
370 mutex_lock(&devices_mutex);
371 gluebi = find_gluebi_nolock(vi->ubi_num, vi->vol_id);
372 if (!gluebi) {
373 err_msg("got remove notification for unknown UBI device %d volume %d",
374 vi->ubi_num, vi->vol_id);
375 err = -ENOENT;
376 } else if (gluebi->refcnt)
377 err = -EBUSY;
378 else
379 list_del(&gluebi->list);
380 mutex_unlock(&devices_mutex);
381 if (err)
382 return err;
384 mtd = &gluebi->mtd;
385 err = mtd_device_unregister(mtd);
386 if (err) {
387 err_msg("cannot remove fake MTD device %d, UBI device %d, volume %d, error %d",
388 mtd->index, gluebi->ubi_num, gluebi->vol_id, err);
389 mutex_lock(&devices_mutex);
390 list_add_tail(&gluebi->list, &gluebi_devices);
391 mutex_unlock(&devices_mutex);
392 return err;
395 kfree(mtd->name);
396 kfree(gluebi);
397 return 0;
401 * gluebi_updated - UBI volume was updated notifier.
402 * @vi: volume info structure
404 * This function is called every time an UBI volume is updated. It does nothing
405 * if te volume @vol is dynamic, and changes MTD device size if the
406 * volume is static. This is needed because static volumes cannot be read past
407 * data they contain. This function returns zero in case of success and a
408 * negative error code in case of error.
410 static int gluebi_updated(struct ubi_volume_info *vi)
412 struct gluebi_device *gluebi;
414 mutex_lock(&devices_mutex);
415 gluebi = find_gluebi_nolock(vi->ubi_num, vi->vol_id);
416 if (!gluebi) {
417 mutex_unlock(&devices_mutex);
418 err_msg("got update notification for unknown UBI device %d volume %d",
419 vi->ubi_num, vi->vol_id);
420 return -ENOENT;
423 if (vi->vol_type == UBI_STATIC_VOLUME)
424 gluebi->mtd.size = vi->used_bytes;
425 mutex_unlock(&devices_mutex);
426 return 0;
430 * gluebi_resized - UBI volume was re-sized notifier.
431 * @vi: volume info structure
433 * This function is called every time an UBI volume is re-size. It changes the
434 * corresponding fake MTD device size. This function returns zero in case of
435 * success and a negative error code in case of error.
437 static int gluebi_resized(struct ubi_volume_info *vi)
439 struct gluebi_device *gluebi;
441 mutex_lock(&devices_mutex);
442 gluebi = find_gluebi_nolock(vi->ubi_num, vi->vol_id);
443 if (!gluebi) {
444 mutex_unlock(&devices_mutex);
445 err_msg("got update notification for unknown UBI device %d volume %d",
446 vi->ubi_num, vi->vol_id);
447 return -ENOENT;
449 gluebi->mtd.size = vi->used_bytes;
450 mutex_unlock(&devices_mutex);
451 return 0;
455 * gluebi_notify - UBI notification handler.
456 * @nb: registered notifier block
457 * @l: notification type
458 * @ptr: pointer to the &struct ubi_notification object
460 static int gluebi_notify(struct notifier_block *nb, unsigned long l,
461 void *ns_ptr)
463 struct ubi_notification *nt = ns_ptr;
465 switch (l) {
466 case UBI_VOLUME_ADDED:
467 gluebi_create(&nt->di, &nt->vi);
468 break;
469 case UBI_VOLUME_REMOVED:
470 gluebi_remove(&nt->vi);
471 break;
472 case UBI_VOLUME_RESIZED:
473 gluebi_resized(&nt->vi);
474 break;
475 case UBI_VOLUME_UPDATED:
476 gluebi_updated(&nt->vi);
477 break;
478 default:
479 break;
481 return NOTIFY_OK;
484 static struct notifier_block gluebi_notifier = {
485 .notifier_call = gluebi_notify,
488 static int __init ubi_gluebi_init(void)
490 return ubi_register_volume_notifier(&gluebi_notifier, 0);
493 static void __exit ubi_gluebi_exit(void)
495 struct gluebi_device *gluebi, *g;
497 list_for_each_entry_safe(gluebi, g, &gluebi_devices, list) {
498 int err;
499 struct mtd_info *mtd = &gluebi->mtd;
501 err = mtd_device_unregister(mtd);
502 if (err)
503 err_msg("error %d while removing gluebi MTD device %d, UBI device %d, volume %d - ignoring",
504 err, mtd->index, gluebi->ubi_num,
505 gluebi->vol_id);
506 kfree(mtd->name);
507 kfree(gluebi);
509 ubi_unregister_volume_notifier(&gluebi_notifier);
512 module_init(ubi_gluebi_init);
513 module_exit(ubi_gluebi_exit);
514 MODULE_DESCRIPTION("MTD emulation layer over UBI volumes");
515 MODULE_AUTHOR("Artem Bityutskiy, Joern Engel");
516 MODULE_LICENSE("GPL");