Linux Audio

Check our new training course

Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/*
  3 * Copyright (c) International Business Machines Corp., 2006
  4 *
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  5 * Author: Artem Bityutskiy (Битюцкий Артём)
  6 */
  7
  8/*
  9 * This file contains implementation of volume creation, deletion, updating and
 10 * resizing.
 11 */
 12
 13#include <linux/err.h>
 14#include <linux/math64.h>
 15#include <linux/slab.h>
 16#include <linux/export.h>
 17#include "ubi.h"
 18
 19static int self_check_volumes(struct ubi_device *ubi);
 
 
 
 
 20
 21static ssize_t vol_attribute_show(struct device *dev,
 22				  struct device_attribute *attr, char *buf);
 23
 24/* Device attributes corresponding to files in '/<sysfs>/class/ubi/ubiX_Y' */
 25static struct device_attribute attr_vol_reserved_ebs =
 26	__ATTR(reserved_ebs, S_IRUGO, vol_attribute_show, NULL);
 27static struct device_attribute attr_vol_type =
 28	__ATTR(type, S_IRUGO, vol_attribute_show, NULL);
 29static struct device_attribute attr_vol_name =
 30	__ATTR(name, S_IRUGO, vol_attribute_show, NULL);
 31static struct device_attribute attr_vol_corrupted =
 32	__ATTR(corrupted, S_IRUGO, vol_attribute_show, NULL);
 33static struct device_attribute attr_vol_alignment =
 34	__ATTR(alignment, S_IRUGO, vol_attribute_show, NULL);
 35static struct device_attribute attr_vol_usable_eb_size =
 36	__ATTR(usable_eb_size, S_IRUGO, vol_attribute_show, NULL);
 37static struct device_attribute attr_vol_data_bytes =
 38	__ATTR(data_bytes, S_IRUGO, vol_attribute_show, NULL);
 39static struct device_attribute attr_vol_upd_marker =
 40	__ATTR(upd_marker, S_IRUGO, vol_attribute_show, NULL);
 41
 42/*
 43 * "Show" method for files in '/<sysfs>/class/ubi/ubiX_Y/'.
 44 *
 45 * Consider a situation:
 46 * A. process 1 opens a sysfs file related to volume Y, say
 47 *    /<sysfs>/class/ubi/ubiX_Y/reserved_ebs;
 48 * B. process 2 removes volume Y;
 49 * C. process 1 starts reading the /<sysfs>/class/ubi/ubiX_Y/reserved_ebs file;
 50 *
 51 * In this situation, this function will return %-ENODEV because it will find
 52 * out that the volume was removed from the @ubi->volumes array.
 53 */
 54static ssize_t vol_attribute_show(struct device *dev,
 55				  struct device_attribute *attr, char *buf)
 56{
 57	int ret;
 58	struct ubi_volume *vol = container_of(dev, struct ubi_volume, dev);
 59	struct ubi_device *ubi = vol->ubi;
 
 
 
 
 60
 61	spin_lock(&ubi->volumes_lock);
 62	if (!ubi->volumes[vol->vol_id]) {
 63		spin_unlock(&ubi->volumes_lock);
 
 64		return -ENODEV;
 65	}
 66	/* Take a reference to prevent volume removal */
 67	vol->ref_count += 1;
 68	spin_unlock(&ubi->volumes_lock);
 69
 70	if (attr == &attr_vol_reserved_ebs)
 71		ret = sprintf(buf, "%d\n", vol->reserved_pebs);
 72	else if (attr == &attr_vol_type) {
 73		const char *tp;
 74
 75		if (vol->vol_type == UBI_DYNAMIC_VOLUME)
 76			tp = "dynamic";
 77		else
 78			tp = "static";
 79		ret = sprintf(buf, "%s\n", tp);
 80	} else if (attr == &attr_vol_name)
 81		ret = sprintf(buf, "%s\n", vol->name);
 82	else if (attr == &attr_vol_corrupted)
 83		ret = sprintf(buf, "%d\n", vol->corrupted);
 84	else if (attr == &attr_vol_alignment)
 85		ret = sprintf(buf, "%d\n", vol->alignment);
 86	else if (attr == &attr_vol_usable_eb_size)
 87		ret = sprintf(buf, "%d\n", vol->usable_leb_size);
 88	else if (attr == &attr_vol_data_bytes)
 89		ret = sprintf(buf, "%lld\n", vol->used_bytes);
 90	else if (attr == &attr_vol_upd_marker)
 91		ret = sprintf(buf, "%d\n", vol->upd_marker);
 92	else
 93		/* This must be a bug */
 94		ret = -EINVAL;
 95
 96	/* We've done the operation, drop volume and UBI device references */
 97	spin_lock(&ubi->volumes_lock);
 98	vol->ref_count -= 1;
 99	ubi_assert(vol->ref_count >= 0);
100	spin_unlock(&ubi->volumes_lock);
 
101	return ret;
102}
103
104static struct attribute *volume_dev_attrs[] = {
105	&attr_vol_reserved_ebs.attr,
106	&attr_vol_type.attr,
107	&attr_vol_name.attr,
108	&attr_vol_corrupted.attr,
109	&attr_vol_alignment.attr,
110	&attr_vol_usable_eb_size.attr,
111	&attr_vol_data_bytes.attr,
112	&attr_vol_upd_marker.attr,
113	NULL
114};
115ATTRIBUTE_GROUPS(volume_dev);
116
117/* Release method for volume devices */
118static void vol_release(struct device *dev)
119{
120	struct ubi_volume *vol = container_of(dev, struct ubi_volume, dev);
121
122	ubi_eba_replace_table(vol, NULL);
123	ubi_fastmap_destroy_checkmap(vol);
124	kfree(vol);
125}
126
127/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
128 * ubi_create_volume - create volume.
129 * @ubi: UBI device description object
130 * @req: volume creation request
131 *
132 * This function creates volume described by @req. If @req->vol_id id
133 * %UBI_VOL_NUM_AUTO, this function automatically assign ID to the new volume
134 * and saves it in @req->vol_id. Returns zero in case of success and a negative
135 * error code in case of failure. Note, the caller has to have the
136 * @ubi->device_mutex locked.
137 */
138int ubi_create_volume(struct ubi_device *ubi, struct ubi_mkvol_req *req)
139{
140	int i, err, vol_id = req->vol_id;
141	struct ubi_volume *vol;
142	struct ubi_vtbl_record vtbl_rec;
143	struct ubi_eba_table *eba_tbl = NULL;
144
145	if (ubi->ro_mode)
146		return -EROFS;
147
148	vol = kzalloc(sizeof(struct ubi_volume), GFP_KERNEL);
149	if (!vol)
150		return -ENOMEM;
151
152	device_initialize(&vol->dev);
153	vol->dev.release = vol_release;
154	vol->dev.parent = &ubi->dev;
155	vol->dev.class = &ubi_class;
156	vol->dev.groups = volume_dev_groups;
157
158	if (req->flags & UBI_VOL_SKIP_CRC_CHECK_FLG)
159		vol->skip_check = 1;
160
161	spin_lock(&ubi->volumes_lock);
162	if (vol_id == UBI_VOL_NUM_AUTO) {
163		/* Find unused volume ID */
164		dbg_gen("search for vacant volume ID");
165		for (i = 0; i < ubi->vtbl_slots; i++)
166			if (!ubi->volumes[i]) {
167				vol_id = i;
168				break;
169			}
170
171		if (vol_id == UBI_VOL_NUM_AUTO) {
172			ubi_err(ubi, "out of volume IDs");
173			err = -ENFILE;
174			goto out_unlock;
175		}
176		req->vol_id = vol_id;
177	}
178
179	dbg_gen("create device %d, volume %d, %llu bytes, type %d, name %s",
180		ubi->ubi_num, vol_id, (unsigned long long)req->bytes,
181		(int)req->vol_type, req->name);
182
183	/* Ensure that this volume does not exist */
184	err = -EEXIST;
185	if (ubi->volumes[vol_id]) {
186		ubi_err(ubi, "volume %d already exists", vol_id);
187		goto out_unlock;
188	}
189
190	/* Ensure that the name is unique */
191	for (i = 0; i < ubi->vtbl_slots; i++)
192		if (ubi->volumes[i] &&
193		    ubi->volumes[i]->name_len == req->name_len &&
194		    !strcmp(ubi->volumes[i]->name, req->name)) {
195			ubi_err(ubi, "volume \"%s\" exists (ID %d)",
196				req->name, i);
197			goto out_unlock;
198		}
199
200	/* Calculate how many eraseblocks are requested */
201	vol->usable_leb_size = ubi->leb_size - ubi->leb_size % req->alignment;
202	vol->reserved_pebs = div_u64(req->bytes + vol->usable_leb_size - 1,
203				     vol->usable_leb_size);
204
205	/* Reserve physical eraseblocks */
206	if (vol->reserved_pebs > ubi->avail_pebs) {
207		ubi_err(ubi, "not enough PEBs, only %d available",
208			ubi->avail_pebs);
209		if (ubi->corr_peb_count)
210			ubi_err(ubi, "%d PEBs are corrupted and not used",
211				ubi->corr_peb_count);
212		err = -ENOSPC;
213		goto out_unlock;
214	}
215	ubi->avail_pebs -= vol->reserved_pebs;
216	ubi->rsvd_pebs += vol->reserved_pebs;
217	spin_unlock(&ubi->volumes_lock);
218
219	vol->vol_id    = vol_id;
220	vol->alignment = req->alignment;
221	vol->data_pad  = ubi->leb_size % vol->alignment;
222	vol->vol_type  = req->vol_type;
223	vol->name_len  = req->name_len;
224	memcpy(vol->name, req->name, vol->name_len);
225	vol->ubi = ubi;
226
227	/*
228	 * Finish all pending erases because there may be some LEBs belonging
229	 * to the same volume ID.
230	 */
231	err = ubi_wl_flush(ubi, vol_id, UBI_ALL);
232	if (err)
233		goto out_acc;
234
235	eba_tbl = ubi_eba_create_table(vol, vol->reserved_pebs);
236	if (IS_ERR(eba_tbl)) {
237		err = PTR_ERR(eba_tbl);
238		goto out_acc;
239	}
240
241	ubi_eba_replace_table(vol, eba_tbl);
 
242
243	if (vol->vol_type == UBI_DYNAMIC_VOLUME) {
244		vol->used_ebs = vol->reserved_pebs;
245		vol->last_eb_bytes = vol->usable_leb_size;
246		vol->used_bytes =
247			(long long)vol->used_ebs * vol->usable_leb_size;
248	} else {
249		vol->used_ebs = div_u64_rem(vol->used_bytes,
250					    vol->usable_leb_size,
251					    &vol->last_eb_bytes);
252		if (vol->last_eb_bytes != 0)
253			vol->used_ebs += 1;
254		else
255			vol->last_eb_bytes = vol->usable_leb_size;
256	}
257
258	/* Make volume "available" before it becomes accessible via sysfs */
259	spin_lock(&ubi->volumes_lock);
260	ubi->volumes[vol_id] = vol;
261	ubi->vol_count += 1;
262	spin_unlock(&ubi->volumes_lock);
263
264	/* Register character device for the volume */
265	cdev_init(&vol->cdev, &ubi_vol_cdev_operations);
266	vol->cdev.owner = THIS_MODULE;
 
 
 
 
 
 
 
 
 
 
 
267
268	vol->dev.devt = MKDEV(MAJOR(ubi->cdev.dev), vol_id + 1);
269	dev_set_name(&vol->dev, "%s_%d", ubi->ubi_name, vol->vol_id);
270	err = cdev_device_add(&vol->cdev, &vol->dev);
271	if (err) {
272		ubi_err(ubi, "cannot add device");
273		goto out_mapping;
274	}
275
 
 
 
 
276	/* Fill volume table record */
277	memset(&vtbl_rec, 0, sizeof(struct ubi_vtbl_record));
278	vtbl_rec.reserved_pebs = cpu_to_be32(vol->reserved_pebs);
279	vtbl_rec.alignment     = cpu_to_be32(vol->alignment);
280	vtbl_rec.data_pad      = cpu_to_be32(vol->data_pad);
281	vtbl_rec.name_len      = cpu_to_be16(vol->name_len);
282	if (vol->vol_type == UBI_DYNAMIC_VOLUME)
283		vtbl_rec.vol_type = UBI_VID_DYNAMIC;
284	else
285		vtbl_rec.vol_type = UBI_VID_STATIC;
286
287	if (vol->skip_check)
288		vtbl_rec.flags |= UBI_VTBL_SKIP_CRC_CHECK_FLG;
289
290	memcpy(vtbl_rec.name, vol->name, vol->name_len);
291
292	err = ubi_change_vtbl_record(ubi, vol_id, &vtbl_rec);
293	if (err)
294		goto out_sysfs;
295
 
 
 
 
 
296	ubi_volume_notify(ubi, vol, UBI_VOLUME_ADDED);
297	self_check_volumes(ubi);
 
298	return err;
299
300out_sysfs:
301	/*
302	 * We have registered our device, we should not free the volume
303	 * description object in this function in case of an error - it is
304	 * freed by the release function.
 
 
 
305	 */
306	cdev_device_del(&vol->cdev, &vol->dev);
 
 
 
 
307out_mapping:
308	spin_lock(&ubi->volumes_lock);
309	ubi->volumes[vol_id] = NULL;
310	ubi->vol_count -= 1;
311	spin_unlock(&ubi->volumes_lock);
312out_acc:
313	spin_lock(&ubi->volumes_lock);
314	ubi->rsvd_pebs -= vol->reserved_pebs;
315	ubi->avail_pebs += vol->reserved_pebs;
316out_unlock:
317	spin_unlock(&ubi->volumes_lock);
318	put_device(&vol->dev);
319	ubi_err(ubi, "cannot create volume %d, error %d", vol_id, err);
 
 
 
320	return err;
321}
322
323/**
324 * ubi_remove_volume - remove volume.
325 * @desc: volume descriptor
326 * @no_vtbl: do not change volume table if not zero
327 *
328 * This function removes volume described by @desc. The volume has to be opened
329 * in "exclusive" mode. Returns zero in case of success and a negative error
330 * code in case of failure. The caller has to have the @ubi->device_mutex
331 * locked.
332 */
333int ubi_remove_volume(struct ubi_volume_desc *desc, int no_vtbl)
334{
335	struct ubi_volume *vol = desc->vol;
336	struct ubi_device *ubi = vol->ubi;
337	int i, err, vol_id = vol->vol_id, reserved_pebs = vol->reserved_pebs;
338
339	dbg_gen("remove device %d, volume %d", ubi->ubi_num, vol_id);
340	ubi_assert(desc->mode == UBI_EXCLUSIVE);
341	ubi_assert(vol == ubi->volumes[vol_id]);
342
343	if (ubi->ro_mode)
344		return -EROFS;
345
346	spin_lock(&ubi->volumes_lock);
347	if (vol->ref_count > 1) {
348		/*
349		 * The volume is busy, probably someone is reading one of its
350		 * sysfs files.
351		 */
352		err = -EBUSY;
353		goto out_unlock;
354	}
355	ubi->volumes[vol_id] = NULL;
356	spin_unlock(&ubi->volumes_lock);
357
358	if (!no_vtbl) {
359		err = ubi_change_vtbl_record(ubi, vol_id, NULL);
360		if (err)
361			goto out_err;
362	}
363
364	for (i = 0; i < vol->reserved_pebs; i++) {
365		err = ubi_eba_unmap_leb(ubi, vol, i);
366		if (err)
367			goto out_err;
368	}
369
370	cdev_device_del(&vol->cdev, &vol->dev);
371	put_device(&vol->dev);
372
373	spin_lock(&ubi->volumes_lock);
374	ubi->rsvd_pebs -= reserved_pebs;
375	ubi->avail_pebs += reserved_pebs;
376	ubi_update_reserved(ubi);
 
 
 
 
 
 
 
 
377	ubi->vol_count -= 1;
378	spin_unlock(&ubi->volumes_lock);
379
380	ubi_volume_notify(ubi, vol, UBI_VOLUME_REMOVED);
381	if (!no_vtbl)
382		self_check_volumes(ubi);
383
384	return 0;
385
386out_err:
387	ubi_err(ubi, "cannot remove volume %d, error %d", vol_id, err);
388	spin_lock(&ubi->volumes_lock);
389	ubi->volumes[vol_id] = vol;
390out_unlock:
391	spin_unlock(&ubi->volumes_lock);
392	return err;
393}
394
395/**
396 * ubi_resize_volume - re-size volume.
397 * @desc: volume descriptor
398 * @reserved_pebs: new size in physical eraseblocks
399 *
400 * This function re-sizes the volume and returns zero in case of success, and a
401 * negative error code in case of failure. The caller has to have the
402 * @ubi->device_mutex locked.
403 */
404int ubi_resize_volume(struct ubi_volume_desc *desc, int reserved_pebs)
405{
406	int i, err, pebs;
407	struct ubi_volume *vol = desc->vol;
408	struct ubi_device *ubi = vol->ubi;
409	struct ubi_vtbl_record vtbl_rec;
410	struct ubi_eba_table *new_eba_tbl = NULL;
411	int vol_id = vol->vol_id;
412
413	if (ubi->ro_mode)
414		return -EROFS;
415
416	dbg_gen("re-size device %d, volume %d to from %d to %d PEBs",
417		ubi->ubi_num, vol_id, vol->reserved_pebs, reserved_pebs);
418
419	if (vol->vol_type == UBI_STATIC_VOLUME &&
420	    reserved_pebs < vol->used_ebs) {
421		ubi_err(ubi, "too small size %d, %d LEBs contain data",
422			reserved_pebs, vol->used_ebs);
423		return -EINVAL;
424	}
425
426	/* If the size is the same, we have nothing to do */
427	if (reserved_pebs == vol->reserved_pebs)
428		return 0;
429
430	new_eba_tbl = ubi_eba_create_table(vol, reserved_pebs);
431	if (IS_ERR(new_eba_tbl))
432		return PTR_ERR(new_eba_tbl);
 
 
 
433
434	spin_lock(&ubi->volumes_lock);
435	if (vol->ref_count > 1) {
436		spin_unlock(&ubi->volumes_lock);
437		err = -EBUSY;
438		goto out_free;
439	}
440	spin_unlock(&ubi->volumes_lock);
441
442	/* Reserve physical eraseblocks */
443	pebs = reserved_pebs - vol->reserved_pebs;
444	if (pebs > 0) {
445		spin_lock(&ubi->volumes_lock);
446		if (pebs > ubi->avail_pebs) {
447			ubi_err(ubi, "not enough PEBs: requested %d, available %d",
448				pebs, ubi->avail_pebs);
449			if (ubi->corr_peb_count)
450				ubi_err(ubi, "%d PEBs are corrupted and not used",
451					ubi->corr_peb_count);
452			spin_unlock(&ubi->volumes_lock);
453			err = -ENOSPC;
454			goto out_free;
455		}
456		ubi->avail_pebs -= pebs;
457		ubi->rsvd_pebs += pebs;
458		ubi_eba_copy_table(vol, new_eba_tbl, vol->reserved_pebs);
459		ubi_eba_replace_table(vol, new_eba_tbl);
 
 
460		spin_unlock(&ubi->volumes_lock);
461	}
462
 
 
 
 
 
 
 
463	if (pebs < 0) {
464		for (i = 0; i < -pebs; i++) {
465			err = ubi_eba_unmap_leb(ubi, vol, reserved_pebs + i);
466			if (err)
467				goto out_free;
468		}
469		spin_lock(&ubi->volumes_lock);
470		ubi->rsvd_pebs += pebs;
471		ubi->avail_pebs -= pebs;
472		ubi_update_reserved(ubi);
473		ubi_eba_copy_table(vol, new_eba_tbl, reserved_pebs);
474		ubi_eba_replace_table(vol, new_eba_tbl);
 
 
 
 
 
 
 
 
 
 
475		spin_unlock(&ubi->volumes_lock);
476	}
477
478	/*
479	 * When we shrink a volume we have to flush all pending (erase) work.
480	 * Otherwise it can happen that upon next attach UBI finds a LEB with
481	 * lnum > highest_lnum and refuses to attach.
482	 */
483	if (pebs < 0) {
484		err = ubi_wl_flush(ubi, vol_id, UBI_ALL);
485		if (err)
486			goto out_acc;
487	}
488
489	/* Change volume table record */
490	vtbl_rec = ubi->vtbl[vol_id];
491	vtbl_rec.reserved_pebs = cpu_to_be32(reserved_pebs);
492	err = ubi_change_vtbl_record(ubi, vol_id, &vtbl_rec);
493	if (err)
494		goto out_acc;
495
496	vol->reserved_pebs = reserved_pebs;
497	if (vol->vol_type == UBI_DYNAMIC_VOLUME) {
498		vol->used_ebs = reserved_pebs;
499		vol->last_eb_bytes = vol->usable_leb_size;
500		vol->used_bytes =
501			(long long)vol->used_ebs * vol->usable_leb_size;
502	}
503
504	ubi_volume_notify(ubi, vol, UBI_VOLUME_RESIZED);
505	self_check_volumes(ubi);
 
506	return err;
507
508out_acc:
509	if (pebs > 0) {
510		spin_lock(&ubi->volumes_lock);
511		ubi->rsvd_pebs -= pebs;
512		ubi->avail_pebs += pebs;
513		spin_unlock(&ubi->volumes_lock);
514	}
515	return err;
516
517out_free:
518	ubi_eba_destroy_table(new_eba_tbl);
519	return err;
520}
521
522/**
523 * ubi_rename_volumes - re-name UBI volumes.
524 * @ubi: UBI device description object
525 * @rename_list: list of &struct ubi_rename_entry objects
526 *
527 * This function re-names or removes volumes specified in the re-name list.
528 * Returns zero in case of success and a negative error code in case of
529 * failure.
530 */
531int ubi_rename_volumes(struct ubi_device *ubi, struct list_head *rename_list)
532{
533	int err;
534	struct ubi_rename_entry *re;
535
536	err = ubi_vtbl_rename_volumes(ubi, rename_list);
537	if (err)
538		return err;
539
540	list_for_each_entry(re, rename_list, list) {
541		if (re->remove) {
542			err = ubi_remove_volume(re->desc, 1);
543			if (err)
544				break;
545		} else {
546			struct ubi_volume *vol = re->desc->vol;
547
548			spin_lock(&ubi->volumes_lock);
549			vol->name_len = re->new_name_len;
550			memcpy(vol->name, re->new_name, re->new_name_len + 1);
551			spin_unlock(&ubi->volumes_lock);
552			ubi_volume_notify(ubi, vol, UBI_VOLUME_RENAMED);
553		}
554	}
555
556	if (!err)
557		self_check_volumes(ubi);
558	return err;
559}
560
561/**
562 * ubi_add_volume - add volume.
563 * @ubi: UBI device description object
564 * @vol: volume description object
565 *
566 * This function adds an existing volume and initializes all its data
567 * structures. Returns zero in case of success and a negative error code in
568 * case of failure.
569 */
570int ubi_add_volume(struct ubi_device *ubi, struct ubi_volume *vol)
571{
572	int err, vol_id = vol->vol_id;
573	dev_t dev;
574
575	dbg_gen("add volume %d", vol_id);
576
577	/* Register character device for the volume */
578	cdev_init(&vol->cdev, &ubi_vol_cdev_operations);
579	vol->cdev.owner = THIS_MODULE;
580	dev = MKDEV(MAJOR(ubi->cdev.dev), vol->vol_id + 1);
581	err = cdev_add(&vol->cdev, dev, 1);
582	if (err) {
583		ubi_err(ubi, "cannot add character device for volume %d, error %d",
584			vol_id, err);
585		vol_release(&vol->dev);
586		return err;
587	}
588
589	vol->dev.release = vol_release;
590	vol->dev.parent = &ubi->dev;
591	vol->dev.devt = dev;
592	vol->dev.class = &ubi_class;
593	vol->dev.groups = volume_dev_groups;
594	dev_set_name(&vol->dev, "%s_%d", ubi->ubi_name, vol->vol_id);
595	err = device_register(&vol->dev);
 
 
 
 
596	if (err) {
597		cdev_del(&vol->cdev);
598		put_device(&vol->dev);
599		return err;
600	}
601
602	self_check_volumes(ubi);
 
 
 
 
 
603	return err;
604}
605
606/**
607 * ubi_free_volume - free volume.
608 * @ubi: UBI device description object
609 * @vol: volume description object
610 *
611 * This function frees all resources for volume @vol but does not remove it.
612 * Used only when the UBI device is detached.
613 */
614void ubi_free_volume(struct ubi_device *ubi, struct ubi_volume *vol)
615{
616	dbg_gen("free volume %d", vol->vol_id);
617
618	ubi->volumes[vol->vol_id] = NULL;
619	cdev_del(&vol->cdev);
620	device_unregister(&vol->dev);
621}
622
 
 
623/**
624 * self_check_volume - check volume information.
625 * @ubi: UBI device description object
626 * @vol_id: volume ID
627 *
628 * Returns zero if volume is all right and a negative error code if not.
629 */
630static int self_check_volume(struct ubi_device *ubi, int vol_id)
631{
632	int idx = vol_id2idx(ubi, vol_id);
633	int reserved_pebs, alignment, data_pad, vol_type, name_len, upd_marker;
634	const struct ubi_volume *vol;
635	long long n;
636	const char *name;
637
638	spin_lock(&ubi->volumes_lock);
639	reserved_pebs = be32_to_cpu(ubi->vtbl[vol_id].reserved_pebs);
640	vol = ubi->volumes[idx];
641
642	if (!vol) {
643		if (reserved_pebs) {
644			ubi_err(ubi, "no volume info, but volume exists");
645			goto fail;
646		}
647		spin_unlock(&ubi->volumes_lock);
648		return 0;
649	}
650
651	if (vol->reserved_pebs < 0 || vol->alignment < 0 || vol->data_pad < 0 ||
652	    vol->name_len < 0) {
653		ubi_err(ubi, "negative values");
654		goto fail;
655	}
656	if (vol->alignment > ubi->leb_size || vol->alignment == 0) {
657		ubi_err(ubi, "bad alignment");
658		goto fail;
659	}
660
661	n = vol->alignment & (ubi->min_io_size - 1);
662	if (vol->alignment != 1 && n) {
663		ubi_err(ubi, "alignment is not multiple of min I/O unit");
664		goto fail;
665	}
666
667	n = ubi->leb_size % vol->alignment;
668	if (vol->data_pad != n) {
669		ubi_err(ubi, "bad data_pad, has to be %lld", n);
670		goto fail;
671	}
672
673	if (vol->vol_type != UBI_DYNAMIC_VOLUME &&
674	    vol->vol_type != UBI_STATIC_VOLUME) {
675		ubi_err(ubi, "bad vol_type");
676		goto fail;
677	}
678
679	if (vol->upd_marker && vol->corrupted) {
680		ubi_err(ubi, "update marker and corrupted simultaneously");
681		goto fail;
682	}
683
684	if (vol->reserved_pebs > ubi->good_peb_count) {
685		ubi_err(ubi, "too large reserved_pebs");
686		goto fail;
687	}
688
689	n = ubi->leb_size - vol->data_pad;
690	if (vol->usable_leb_size != ubi->leb_size - vol->data_pad) {
691		ubi_err(ubi, "bad usable_leb_size, has to be %lld", n);
692		goto fail;
693	}
694
695	if (vol->name_len > UBI_VOL_NAME_MAX) {
696		ubi_err(ubi, "too long volume name, max is %d",
697			UBI_VOL_NAME_MAX);
698		goto fail;
699	}
700
701	n = strnlen(vol->name, vol->name_len + 1);
702	if (n != vol->name_len) {
703		ubi_err(ubi, "bad name_len %lld", n);
704		goto fail;
705	}
706
707	n = (long long)vol->used_ebs * vol->usable_leb_size;
708	if (vol->vol_type == UBI_DYNAMIC_VOLUME) {
709		if (vol->corrupted) {
710			ubi_err(ubi, "corrupted dynamic volume");
711			goto fail;
712		}
713		if (vol->used_ebs != vol->reserved_pebs) {
714			ubi_err(ubi, "bad used_ebs");
715			goto fail;
716		}
717		if (vol->last_eb_bytes != vol->usable_leb_size) {
718			ubi_err(ubi, "bad last_eb_bytes");
719			goto fail;
720		}
721		if (vol->used_bytes != n) {
722			ubi_err(ubi, "bad used_bytes");
723			goto fail;
724		}
725
726		if (vol->skip_check) {
727			ubi_err(ubi, "bad skip_check");
728			goto fail;
729		}
730	} else {
731		if (vol->used_ebs < 0 || vol->used_ebs > vol->reserved_pebs) {
732			ubi_err(ubi, "bad used_ebs");
733			goto fail;
734		}
735		if (vol->last_eb_bytes < 0 ||
736		    vol->last_eb_bytes > vol->usable_leb_size) {
737			ubi_err(ubi, "bad last_eb_bytes");
738			goto fail;
739		}
740		if (vol->used_bytes < 0 || vol->used_bytes > n ||
741		    vol->used_bytes < n - vol->usable_leb_size) {
742			ubi_err(ubi, "bad used_bytes");
743			goto fail;
744		}
745	}
746
747	alignment  = be32_to_cpu(ubi->vtbl[vol_id].alignment);
748	data_pad   = be32_to_cpu(ubi->vtbl[vol_id].data_pad);
749	name_len   = be16_to_cpu(ubi->vtbl[vol_id].name_len);
750	upd_marker = ubi->vtbl[vol_id].upd_marker;
751	name       = &ubi->vtbl[vol_id].name[0];
752	if (ubi->vtbl[vol_id].vol_type == UBI_VID_DYNAMIC)
753		vol_type = UBI_DYNAMIC_VOLUME;
754	else
755		vol_type = UBI_STATIC_VOLUME;
756
757	if (alignment != vol->alignment || data_pad != vol->data_pad ||
758	    upd_marker != vol->upd_marker || vol_type != vol->vol_type ||
759	    name_len != vol->name_len || strncmp(name, vol->name, name_len)) {
760		ubi_err(ubi, "volume info is different");
761		goto fail;
762	}
763
764	spin_unlock(&ubi->volumes_lock);
765	return 0;
766
767fail:
768	ubi_err(ubi, "self-check failed for volume %d", vol_id);
769	if (vol)
770		ubi_dump_vol_info(vol);
771	ubi_dump_vtbl_record(&ubi->vtbl[vol_id], vol_id);
772	dump_stack();
773	spin_unlock(&ubi->volumes_lock);
774	return -EINVAL;
775}
776
777/**
778 * self_check_volumes - check information about all volumes.
779 * @ubi: UBI device description object
780 *
781 * Returns zero if volumes are all right and a negative error code if not.
782 */
783static int self_check_volumes(struct ubi_device *ubi)
784{
785	int i, err = 0;
786
787	if (!ubi_dbg_chk_gen(ubi))
788		return 0;
789
790	for (i = 0; i < ubi->vtbl_slots; i++) {
791		err = self_check_volume(ubi, i);
792		if (err)
793			break;
794	}
795
796	return err;
797}
v3.1
 
  1/*
  2 * Copyright (c) International Business Machines Corp., 2006
  3 *
  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.
  8 *
  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.
 13 *
 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
 17 *
 18 * Author: Artem Bityutskiy (Битюцкий Артём)
 19 */
 20
 21/*
 22 * This file contains implementation of volume creation, deletion, updating and
 23 * resizing.
 24 */
 25
 26#include <linux/err.h>
 27#include <linux/math64.h>
 28#include <linux/slab.h>
 
 29#include "ubi.h"
 30
 31#ifdef CONFIG_MTD_UBI_DEBUG
 32static int paranoid_check_volumes(struct ubi_device *ubi);
 33#else
 34#define paranoid_check_volumes(ubi) 0
 35#endif
 36
 37static ssize_t vol_attribute_show(struct device *dev,
 38				  struct device_attribute *attr, char *buf);
 39
 40/* Device attributes corresponding to files in '/<sysfs>/class/ubi/ubiX_Y' */
 41static struct device_attribute attr_vol_reserved_ebs =
 42	__ATTR(reserved_ebs, S_IRUGO, vol_attribute_show, NULL);
 43static struct device_attribute attr_vol_type =
 44	__ATTR(type, S_IRUGO, vol_attribute_show, NULL);
 45static struct device_attribute attr_vol_name =
 46	__ATTR(name, S_IRUGO, vol_attribute_show, NULL);
 47static struct device_attribute attr_vol_corrupted =
 48	__ATTR(corrupted, S_IRUGO, vol_attribute_show, NULL);
 49static struct device_attribute attr_vol_alignment =
 50	__ATTR(alignment, S_IRUGO, vol_attribute_show, NULL);
 51static struct device_attribute attr_vol_usable_eb_size =
 52	__ATTR(usable_eb_size, S_IRUGO, vol_attribute_show, NULL);
 53static struct device_attribute attr_vol_data_bytes =
 54	__ATTR(data_bytes, S_IRUGO, vol_attribute_show, NULL);
 55static struct device_attribute attr_vol_upd_marker =
 56	__ATTR(upd_marker, S_IRUGO, vol_attribute_show, NULL);
 57
 58/*
 59 * "Show" method for files in '/<sysfs>/class/ubi/ubiX_Y/'.
 60 *
 61 * Consider a situation:
 62 * A. process 1 opens a sysfs file related to volume Y, say
 63 *    /<sysfs>/class/ubi/ubiX_Y/reserved_ebs;
 64 * B. process 2 removes volume Y;
 65 * C. process 1 starts reading the /<sysfs>/class/ubi/ubiX_Y/reserved_ebs file;
 66 *
 67 * In this situation, this function will return %-ENODEV because it will find
 68 * out that the volume was removed from the @ubi->volumes array.
 69 */
 70static ssize_t vol_attribute_show(struct device *dev,
 71				  struct device_attribute *attr, char *buf)
 72{
 73	int ret;
 74	struct ubi_volume *vol = container_of(dev, struct ubi_volume, dev);
 75	struct ubi_device *ubi;
 76
 77	ubi = ubi_get_device(vol->ubi->ubi_num);
 78	if (!ubi)
 79		return -ENODEV;
 80
 81	spin_lock(&ubi->volumes_lock);
 82	if (!ubi->volumes[vol->vol_id]) {
 83		spin_unlock(&ubi->volumes_lock);
 84		ubi_put_device(ubi);
 85		return -ENODEV;
 86	}
 87	/* Take a reference to prevent volume removal */
 88	vol->ref_count += 1;
 89	spin_unlock(&ubi->volumes_lock);
 90
 91	if (attr == &attr_vol_reserved_ebs)
 92		ret = sprintf(buf, "%d\n", vol->reserved_pebs);
 93	else if (attr == &attr_vol_type) {
 94		const char *tp;
 95
 96		if (vol->vol_type == UBI_DYNAMIC_VOLUME)
 97			tp = "dynamic";
 98		else
 99			tp = "static";
100		ret = sprintf(buf, "%s\n", tp);
101	} else if (attr == &attr_vol_name)
102		ret = sprintf(buf, "%s\n", vol->name);
103	else if (attr == &attr_vol_corrupted)
104		ret = sprintf(buf, "%d\n", vol->corrupted);
105	else if (attr == &attr_vol_alignment)
106		ret = sprintf(buf, "%d\n", vol->alignment);
107	else if (attr == &attr_vol_usable_eb_size)
108		ret = sprintf(buf, "%d\n", vol->usable_leb_size);
109	else if (attr == &attr_vol_data_bytes)
110		ret = sprintf(buf, "%lld\n", vol->used_bytes);
111	else if (attr == &attr_vol_upd_marker)
112		ret = sprintf(buf, "%d\n", vol->upd_marker);
113	else
114		/* This must be a bug */
115		ret = -EINVAL;
116
117	/* We've done the operation, drop volume and UBI device references */
118	spin_lock(&ubi->volumes_lock);
119	vol->ref_count -= 1;
120	ubi_assert(vol->ref_count >= 0);
121	spin_unlock(&ubi->volumes_lock);
122	ubi_put_device(ubi);
123	return ret;
124}
125
 
 
 
 
 
 
 
 
 
 
 
 
 
126/* Release method for volume devices */
127static void vol_release(struct device *dev)
128{
129	struct ubi_volume *vol = container_of(dev, struct ubi_volume, dev);
130
131	kfree(vol->eba_tbl);
 
132	kfree(vol);
133}
134
135/**
136 * volume_sysfs_init - initialize sysfs for new volume.
137 * @ubi: UBI device description object
138 * @vol: volume description object
139 *
140 * This function returns zero in case of success and a negative error code in
141 * case of failure.
142 *
143 * Note, this function does not free allocated resources in case of failure -
144 * the caller does it. This is because this would cause release() here and the
145 * caller would oops.
146 */
147static int volume_sysfs_init(struct ubi_device *ubi, struct ubi_volume *vol)
148{
149	int err;
150
151	err = device_create_file(&vol->dev, &attr_vol_reserved_ebs);
152	if (err)
153		return err;
154	err = device_create_file(&vol->dev, &attr_vol_type);
155	if (err)
156		return err;
157	err = device_create_file(&vol->dev, &attr_vol_name);
158	if (err)
159		return err;
160	err = device_create_file(&vol->dev, &attr_vol_corrupted);
161	if (err)
162		return err;
163	err = device_create_file(&vol->dev, &attr_vol_alignment);
164	if (err)
165		return err;
166	err = device_create_file(&vol->dev, &attr_vol_usable_eb_size);
167	if (err)
168		return err;
169	err = device_create_file(&vol->dev, &attr_vol_data_bytes);
170	if (err)
171		return err;
172	err = device_create_file(&vol->dev, &attr_vol_upd_marker);
173	return err;
174}
175
176/**
177 * volume_sysfs_close - close sysfs for a volume.
178 * @vol: volume description object
179 */
180static void volume_sysfs_close(struct ubi_volume *vol)
181{
182	device_remove_file(&vol->dev, &attr_vol_upd_marker);
183	device_remove_file(&vol->dev, &attr_vol_data_bytes);
184	device_remove_file(&vol->dev, &attr_vol_usable_eb_size);
185	device_remove_file(&vol->dev, &attr_vol_alignment);
186	device_remove_file(&vol->dev, &attr_vol_corrupted);
187	device_remove_file(&vol->dev, &attr_vol_name);
188	device_remove_file(&vol->dev, &attr_vol_type);
189	device_remove_file(&vol->dev, &attr_vol_reserved_ebs);
190	device_unregister(&vol->dev);
191}
192
193/**
194 * ubi_create_volume - create volume.
195 * @ubi: UBI device description object
196 * @req: volume creation request
197 *
198 * This function creates volume described by @req. If @req->vol_id id
199 * %UBI_VOL_NUM_AUTO, this function automatically assign ID to the new volume
200 * and saves it in @req->vol_id. Returns zero in case of success and a negative
201 * error code in case of failure. Note, the caller has to have the
202 * @ubi->device_mutex locked.
203 */
204int ubi_create_volume(struct ubi_device *ubi, struct ubi_mkvol_req *req)
205{
206	int i, err, vol_id = req->vol_id, do_free = 1;
207	struct ubi_volume *vol;
208	struct ubi_vtbl_record vtbl_rec;
209	dev_t dev;
210
211	if (ubi->ro_mode)
212		return -EROFS;
213
214	vol = kzalloc(sizeof(struct ubi_volume), GFP_KERNEL);
215	if (!vol)
216		return -ENOMEM;
217
 
 
 
 
 
 
 
 
 
218	spin_lock(&ubi->volumes_lock);
219	if (vol_id == UBI_VOL_NUM_AUTO) {
220		/* Find unused volume ID */
221		dbg_gen("search for vacant volume ID");
222		for (i = 0; i < ubi->vtbl_slots; i++)
223			if (!ubi->volumes[i]) {
224				vol_id = i;
225				break;
226			}
227
228		if (vol_id == UBI_VOL_NUM_AUTO) {
229			dbg_err("out of volume IDs");
230			err = -ENFILE;
231			goto out_unlock;
232		}
233		req->vol_id = vol_id;
234	}
235
236	dbg_gen("create device %d, volume %d, %llu bytes, type %d, name %s",
237		ubi->ubi_num, vol_id, (unsigned long long)req->bytes,
238		(int)req->vol_type, req->name);
239
240	/* Ensure that this volume does not exist */
241	err = -EEXIST;
242	if (ubi->volumes[vol_id]) {
243		dbg_err("volume %d already exists", vol_id);
244		goto out_unlock;
245	}
246
247	/* Ensure that the name is unique */
248	for (i = 0; i < ubi->vtbl_slots; i++)
249		if (ubi->volumes[i] &&
250		    ubi->volumes[i]->name_len == req->name_len &&
251		    !strcmp(ubi->volumes[i]->name, req->name)) {
252			dbg_err("volume \"%s\" exists (ID %d)", req->name, i);
 
253			goto out_unlock;
254		}
255
256	/* Calculate how many eraseblocks are requested */
257	vol->usable_leb_size = ubi->leb_size - ubi->leb_size % req->alignment;
258	vol->reserved_pebs += div_u64(req->bytes + vol->usable_leb_size - 1,
259				      vol->usable_leb_size);
260
261	/* Reserve physical eraseblocks */
262	if (vol->reserved_pebs > ubi->avail_pebs) {
263		dbg_err("not enough PEBs, only %d available", ubi->avail_pebs);
 
264		if (ubi->corr_peb_count)
265			dbg_err("%d PEBs are corrupted and not used",
266				ubi->corr_peb_count);
267		err = -ENOSPC;
268		goto out_unlock;
269	}
270	ubi->avail_pebs -= vol->reserved_pebs;
271	ubi->rsvd_pebs += vol->reserved_pebs;
272	spin_unlock(&ubi->volumes_lock);
273
274	vol->vol_id    = vol_id;
275	vol->alignment = req->alignment;
276	vol->data_pad  = ubi->leb_size % vol->alignment;
277	vol->vol_type  = req->vol_type;
278	vol->name_len  = req->name_len;
279	memcpy(vol->name, req->name, vol->name_len);
280	vol->ubi = ubi;
281
282	/*
283	 * Finish all pending erases because there may be some LEBs belonging
284	 * to the same volume ID.
285	 */
286	err = ubi_wl_flush(ubi);
287	if (err)
288		goto out_acc;
289
290	vol->eba_tbl = kmalloc(vol->reserved_pebs * sizeof(int), GFP_KERNEL);
291	if (!vol->eba_tbl) {
292		err = -ENOMEM;
293		goto out_acc;
294	}
295
296	for (i = 0; i < vol->reserved_pebs; i++)
297		vol->eba_tbl[i] = UBI_LEB_UNMAPPED;
298
299	if (vol->vol_type == UBI_DYNAMIC_VOLUME) {
300		vol->used_ebs = vol->reserved_pebs;
301		vol->last_eb_bytes = vol->usable_leb_size;
302		vol->used_bytes =
303			(long long)vol->used_ebs * vol->usable_leb_size;
304	} else {
305		vol->used_ebs = div_u64_rem(vol->used_bytes,
306					    vol->usable_leb_size,
307					    &vol->last_eb_bytes);
308		if (vol->last_eb_bytes != 0)
309			vol->used_ebs += 1;
310		else
311			vol->last_eb_bytes = vol->usable_leb_size;
312	}
313
 
 
 
 
 
 
314	/* Register character device for the volume */
315	cdev_init(&vol->cdev, &ubi_vol_cdev_operations);
316	vol->cdev.owner = THIS_MODULE;
317	dev = MKDEV(MAJOR(ubi->cdev.dev), vol_id + 1);
318	err = cdev_add(&vol->cdev, dev, 1);
319	if (err) {
320		ubi_err("cannot add character device");
321		goto out_mapping;
322	}
323
324	vol->dev.release = vol_release;
325	vol->dev.parent = &ubi->dev;
326	vol->dev.devt = dev;
327	vol->dev.class = ubi_class;
328
 
329	dev_set_name(&vol->dev, "%s_%d", ubi->ubi_name, vol->vol_id);
330	err = device_register(&vol->dev);
331	if (err) {
332		ubi_err("cannot register device");
333		goto out_cdev;
334	}
335
336	err = volume_sysfs_init(ubi, vol);
337	if (err)
338		goto out_sysfs;
339
340	/* Fill volume table record */
341	memset(&vtbl_rec, 0, sizeof(struct ubi_vtbl_record));
342	vtbl_rec.reserved_pebs = cpu_to_be32(vol->reserved_pebs);
343	vtbl_rec.alignment     = cpu_to_be32(vol->alignment);
344	vtbl_rec.data_pad      = cpu_to_be32(vol->data_pad);
345	vtbl_rec.name_len      = cpu_to_be16(vol->name_len);
346	if (vol->vol_type == UBI_DYNAMIC_VOLUME)
347		vtbl_rec.vol_type = UBI_VID_DYNAMIC;
348	else
349		vtbl_rec.vol_type = UBI_VID_STATIC;
 
 
 
 
350	memcpy(vtbl_rec.name, vol->name, vol->name_len);
351
352	err = ubi_change_vtbl_record(ubi, vol_id, &vtbl_rec);
353	if (err)
354		goto out_sysfs;
355
356	spin_lock(&ubi->volumes_lock);
357	ubi->volumes[vol_id] = vol;
358	ubi->vol_count += 1;
359	spin_unlock(&ubi->volumes_lock);
360
361	ubi_volume_notify(ubi, vol, UBI_VOLUME_ADDED);
362	if (paranoid_check_volumes(ubi))
363		dbg_err("check failed while creating volume %d", vol_id);
364	return err;
365
366out_sysfs:
367	/*
368	 * We have registered our device, we should not free the volume
369	 * description object in this function in case of an error - it is
370	 * freed by the release function.
371	 *
372	 * Get device reference to prevent the release function from being
373	 * called just after sysfs has been closed.
374	 */
375	do_free = 0;
376	get_device(&vol->dev);
377	volume_sysfs_close(vol);
378out_cdev:
379	cdev_del(&vol->cdev);
380out_mapping:
381	if (do_free)
382		kfree(vol->eba_tbl);
 
 
383out_acc:
384	spin_lock(&ubi->volumes_lock);
385	ubi->rsvd_pebs -= vol->reserved_pebs;
386	ubi->avail_pebs += vol->reserved_pebs;
387out_unlock:
388	spin_unlock(&ubi->volumes_lock);
389	if (do_free)
390		kfree(vol);
391	else
392		put_device(&vol->dev);
393	ubi_err("cannot create volume %d, error %d", vol_id, err);
394	return err;
395}
396
397/**
398 * ubi_remove_volume - remove volume.
399 * @desc: volume descriptor
400 * @no_vtbl: do not change volume table if not zero
401 *
402 * This function removes volume described by @desc. The volume has to be opened
403 * in "exclusive" mode. Returns zero in case of success and a negative error
404 * code in case of failure. The caller has to have the @ubi->device_mutex
405 * locked.
406 */
407int ubi_remove_volume(struct ubi_volume_desc *desc, int no_vtbl)
408{
409	struct ubi_volume *vol = desc->vol;
410	struct ubi_device *ubi = vol->ubi;
411	int i, err, vol_id = vol->vol_id, reserved_pebs = vol->reserved_pebs;
412
413	dbg_gen("remove device %d, volume %d", ubi->ubi_num, vol_id);
414	ubi_assert(desc->mode == UBI_EXCLUSIVE);
415	ubi_assert(vol == ubi->volumes[vol_id]);
416
417	if (ubi->ro_mode)
418		return -EROFS;
419
420	spin_lock(&ubi->volumes_lock);
421	if (vol->ref_count > 1) {
422		/*
423		 * The volume is busy, probably someone is reading one of its
424		 * sysfs files.
425		 */
426		err = -EBUSY;
427		goto out_unlock;
428	}
429	ubi->volumes[vol_id] = NULL;
430	spin_unlock(&ubi->volumes_lock);
431
432	if (!no_vtbl) {
433		err = ubi_change_vtbl_record(ubi, vol_id, NULL);
434		if (err)
435			goto out_err;
436	}
437
438	for (i = 0; i < vol->reserved_pebs; i++) {
439		err = ubi_eba_unmap_leb(ubi, vol, i);
440		if (err)
441			goto out_err;
442	}
443
444	cdev_del(&vol->cdev);
445	volume_sysfs_close(vol);
446
447	spin_lock(&ubi->volumes_lock);
448	ubi->rsvd_pebs -= reserved_pebs;
449	ubi->avail_pebs += reserved_pebs;
450	i = ubi->beb_rsvd_level - ubi->beb_rsvd_pebs;
451	if (i > 0) {
452		i = ubi->avail_pebs >= i ? i : ubi->avail_pebs;
453		ubi->avail_pebs -= i;
454		ubi->rsvd_pebs += i;
455		ubi->beb_rsvd_pebs += i;
456		if (i > 0)
457			ubi_msg("reserve more %d PEBs", i);
458	}
459	ubi->vol_count -= 1;
460	spin_unlock(&ubi->volumes_lock);
461
462	ubi_volume_notify(ubi, vol, UBI_VOLUME_REMOVED);
463	if (!no_vtbl && paranoid_check_volumes(ubi))
464		dbg_err("check failed while removing volume %d", vol_id);
465
466	return err;
467
468out_err:
469	ubi_err("cannot remove volume %d, error %d", vol_id, err);
470	spin_lock(&ubi->volumes_lock);
471	ubi->volumes[vol_id] = vol;
472out_unlock:
473	spin_unlock(&ubi->volumes_lock);
474	return err;
475}
476
477/**
478 * ubi_resize_volume - re-size volume.
479 * @desc: volume descriptor
480 * @reserved_pebs: new size in physical eraseblocks
481 *
482 * This function re-sizes the volume and returns zero in case of success, and a
483 * negative error code in case of failure. The caller has to have the
484 * @ubi->device_mutex locked.
485 */
486int ubi_resize_volume(struct ubi_volume_desc *desc, int reserved_pebs)
487{
488	int i, err, pebs, *new_mapping;
489	struct ubi_volume *vol = desc->vol;
490	struct ubi_device *ubi = vol->ubi;
491	struct ubi_vtbl_record vtbl_rec;
 
492	int vol_id = vol->vol_id;
493
494	if (ubi->ro_mode)
495		return -EROFS;
496
497	dbg_gen("re-size device %d, volume %d to from %d to %d PEBs",
498		ubi->ubi_num, vol_id, vol->reserved_pebs, reserved_pebs);
499
500	if (vol->vol_type == UBI_STATIC_VOLUME &&
501	    reserved_pebs < vol->used_ebs) {
502		dbg_err("too small size %d, %d LEBs contain data",
503			reserved_pebs, vol->used_ebs);
504		return -EINVAL;
505	}
506
507	/* If the size is the same, we have nothing to do */
508	if (reserved_pebs == vol->reserved_pebs)
509		return 0;
510
511	new_mapping = kmalloc(reserved_pebs * sizeof(int), GFP_KERNEL);
512	if (!new_mapping)
513		return -ENOMEM;
514
515	for (i = 0; i < reserved_pebs; i++)
516		new_mapping[i] = UBI_LEB_UNMAPPED;
517
518	spin_lock(&ubi->volumes_lock);
519	if (vol->ref_count > 1) {
520		spin_unlock(&ubi->volumes_lock);
521		err = -EBUSY;
522		goto out_free;
523	}
524	spin_unlock(&ubi->volumes_lock);
525
526	/* Reserve physical eraseblocks */
527	pebs = reserved_pebs - vol->reserved_pebs;
528	if (pebs > 0) {
529		spin_lock(&ubi->volumes_lock);
530		if (pebs > ubi->avail_pebs) {
531			dbg_err("not enough PEBs: requested %d, available %d",
532				pebs, ubi->avail_pebs);
533			if (ubi->corr_peb_count)
534				dbg_err("%d PEBs are corrupted and not used",
535					ubi->corr_peb_count);
536			spin_unlock(&ubi->volumes_lock);
537			err = -ENOSPC;
538			goto out_free;
539		}
540		ubi->avail_pebs -= pebs;
541		ubi->rsvd_pebs += pebs;
542		for (i = 0; i < vol->reserved_pebs; i++)
543			new_mapping[i] = vol->eba_tbl[i];
544		kfree(vol->eba_tbl);
545		vol->eba_tbl = new_mapping;
546		spin_unlock(&ubi->volumes_lock);
547	}
548
549	/* Change volume table record */
550	memcpy(&vtbl_rec, &ubi->vtbl[vol_id], sizeof(struct ubi_vtbl_record));
551	vtbl_rec.reserved_pebs = cpu_to_be32(reserved_pebs);
552	err = ubi_change_vtbl_record(ubi, vol_id, &vtbl_rec);
553	if (err)
554		goto out_acc;
555
556	if (pebs < 0) {
557		for (i = 0; i < -pebs; i++) {
558			err = ubi_eba_unmap_leb(ubi, vol, reserved_pebs + i);
559			if (err)
560				goto out_acc;
561		}
562		spin_lock(&ubi->volumes_lock);
563		ubi->rsvd_pebs += pebs;
564		ubi->avail_pebs -= pebs;
565		pebs = ubi->beb_rsvd_level - ubi->beb_rsvd_pebs;
566		if (pebs > 0) {
567			pebs = ubi->avail_pebs >= pebs ? pebs : ubi->avail_pebs;
568			ubi->avail_pebs -= pebs;
569			ubi->rsvd_pebs += pebs;
570			ubi->beb_rsvd_pebs += pebs;
571			if (pebs > 0)
572				ubi_msg("reserve more %d PEBs", pebs);
573		}
574		for (i = 0; i < reserved_pebs; i++)
575			new_mapping[i] = vol->eba_tbl[i];
576		kfree(vol->eba_tbl);
577		vol->eba_tbl = new_mapping;
578		spin_unlock(&ubi->volumes_lock);
579	}
580
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
581	vol->reserved_pebs = reserved_pebs;
582	if (vol->vol_type == UBI_DYNAMIC_VOLUME) {
583		vol->used_ebs = reserved_pebs;
584		vol->last_eb_bytes = vol->usable_leb_size;
585		vol->used_bytes =
586			(long long)vol->used_ebs * vol->usable_leb_size;
587	}
588
589	ubi_volume_notify(ubi, vol, UBI_VOLUME_RESIZED);
590	if (paranoid_check_volumes(ubi))
591		dbg_err("check failed while re-sizing volume %d", vol_id);
592	return err;
593
594out_acc:
595	if (pebs > 0) {
596		spin_lock(&ubi->volumes_lock);
597		ubi->rsvd_pebs -= pebs;
598		ubi->avail_pebs += pebs;
599		spin_unlock(&ubi->volumes_lock);
600	}
 
 
601out_free:
602	kfree(new_mapping);
603	return err;
604}
605
606/**
607 * ubi_rename_volumes - re-name UBI volumes.
608 * @ubi: UBI device description object
609 * @rename_list: list of &struct ubi_rename_entry objects
610 *
611 * This function re-names or removes volumes specified in the re-name list.
612 * Returns zero in case of success and a negative error code in case of
613 * failure.
614 */
615int ubi_rename_volumes(struct ubi_device *ubi, struct list_head *rename_list)
616{
617	int err;
618	struct ubi_rename_entry *re;
619
620	err = ubi_vtbl_rename_volumes(ubi, rename_list);
621	if (err)
622		return err;
623
624	list_for_each_entry(re, rename_list, list) {
625		if (re->remove) {
626			err = ubi_remove_volume(re->desc, 1);
627			if (err)
628				break;
629		} else {
630			struct ubi_volume *vol = re->desc->vol;
631
632			spin_lock(&ubi->volumes_lock);
633			vol->name_len = re->new_name_len;
634			memcpy(vol->name, re->new_name, re->new_name_len + 1);
635			spin_unlock(&ubi->volumes_lock);
636			ubi_volume_notify(ubi, vol, UBI_VOLUME_RENAMED);
637		}
638	}
639
640	if (!err && paranoid_check_volumes(ubi))
641		;
642	return err;
643}
644
645/**
646 * ubi_add_volume - add volume.
647 * @ubi: UBI device description object
648 * @vol: volume description object
649 *
650 * This function adds an existing volume and initializes all its data
651 * structures. Returns zero in case of success and a negative error code in
652 * case of failure.
653 */
654int ubi_add_volume(struct ubi_device *ubi, struct ubi_volume *vol)
655{
656	int err, vol_id = vol->vol_id;
657	dev_t dev;
658
659	dbg_gen("add volume %d", vol_id);
660
661	/* Register character device for the volume */
662	cdev_init(&vol->cdev, &ubi_vol_cdev_operations);
663	vol->cdev.owner = THIS_MODULE;
664	dev = MKDEV(MAJOR(ubi->cdev.dev), vol->vol_id + 1);
665	err = cdev_add(&vol->cdev, dev, 1);
666	if (err) {
667		ubi_err("cannot add character device for volume %d, error %d",
668			vol_id, err);
 
669		return err;
670	}
671
672	vol->dev.release = vol_release;
673	vol->dev.parent = &ubi->dev;
674	vol->dev.devt = dev;
675	vol->dev.class = ubi_class;
 
676	dev_set_name(&vol->dev, "%s_%d", ubi->ubi_name, vol->vol_id);
677	err = device_register(&vol->dev);
678	if (err)
679		goto out_cdev;
680
681	err = volume_sysfs_init(ubi, vol);
682	if (err) {
683		cdev_del(&vol->cdev);
684		volume_sysfs_close(vol);
685		return err;
686	}
687
688	if (paranoid_check_volumes(ubi))
689		dbg_err("check failed while adding volume %d", vol_id);
690	return err;
691
692out_cdev:
693	cdev_del(&vol->cdev);
694	return err;
695}
696
697/**
698 * ubi_free_volume - free volume.
699 * @ubi: UBI device description object
700 * @vol: volume description object
701 *
702 * This function frees all resources for volume @vol but does not remove it.
703 * Used only when the UBI device is detached.
704 */
705void ubi_free_volume(struct ubi_device *ubi, struct ubi_volume *vol)
706{
707	dbg_gen("free volume %d", vol->vol_id);
708
709	ubi->volumes[vol->vol_id] = NULL;
710	cdev_del(&vol->cdev);
711	volume_sysfs_close(vol);
712}
713
714#ifdef CONFIG_MTD_UBI_DEBUG
715
716/**
717 * paranoid_check_volume - check volume information.
718 * @ubi: UBI device description object
719 * @vol_id: volume ID
720 *
721 * Returns zero if volume is all right and a a negative error code if not.
722 */
723static int paranoid_check_volume(struct ubi_device *ubi, int vol_id)
724{
725	int idx = vol_id2idx(ubi, vol_id);
726	int reserved_pebs, alignment, data_pad, vol_type, name_len, upd_marker;
727	const struct ubi_volume *vol;
728	long long n;
729	const char *name;
730
731	spin_lock(&ubi->volumes_lock);
732	reserved_pebs = be32_to_cpu(ubi->vtbl[vol_id].reserved_pebs);
733	vol = ubi->volumes[idx];
734
735	if (!vol) {
736		if (reserved_pebs) {
737			ubi_err("no volume info, but volume exists");
738			goto fail;
739		}
740		spin_unlock(&ubi->volumes_lock);
741		return 0;
742	}
743
744	if (vol->reserved_pebs < 0 || vol->alignment < 0 || vol->data_pad < 0 ||
745	    vol->name_len < 0) {
746		ubi_err("negative values");
747		goto fail;
748	}
749	if (vol->alignment > ubi->leb_size || vol->alignment == 0) {
750		ubi_err("bad alignment");
751		goto fail;
752	}
753
754	n = vol->alignment & (ubi->min_io_size - 1);
755	if (vol->alignment != 1 && n) {
756		ubi_err("alignment is not multiple of min I/O unit");
757		goto fail;
758	}
759
760	n = ubi->leb_size % vol->alignment;
761	if (vol->data_pad != n) {
762		ubi_err("bad data_pad, has to be %lld", n);
763		goto fail;
764	}
765
766	if (vol->vol_type != UBI_DYNAMIC_VOLUME &&
767	    vol->vol_type != UBI_STATIC_VOLUME) {
768		ubi_err("bad vol_type");
769		goto fail;
770	}
771
772	if (vol->upd_marker && vol->corrupted) {
773		dbg_err("update marker and corrupted simultaneously");
774		goto fail;
775	}
776
777	if (vol->reserved_pebs > ubi->good_peb_count) {
778		ubi_err("too large reserved_pebs");
779		goto fail;
780	}
781
782	n = ubi->leb_size - vol->data_pad;
783	if (vol->usable_leb_size != ubi->leb_size - vol->data_pad) {
784		ubi_err("bad usable_leb_size, has to be %lld", n);
785		goto fail;
786	}
787
788	if (vol->name_len > UBI_VOL_NAME_MAX) {
789		ubi_err("too long volume name, max is %d", UBI_VOL_NAME_MAX);
 
790		goto fail;
791	}
792
793	n = strnlen(vol->name, vol->name_len + 1);
794	if (n != vol->name_len) {
795		ubi_err("bad name_len %lld", n);
796		goto fail;
797	}
798
799	n = (long long)vol->used_ebs * vol->usable_leb_size;
800	if (vol->vol_type == UBI_DYNAMIC_VOLUME) {
801		if (vol->corrupted) {
802			ubi_err("corrupted dynamic volume");
803			goto fail;
804		}
805		if (vol->used_ebs != vol->reserved_pebs) {
806			ubi_err("bad used_ebs");
807			goto fail;
808		}
809		if (vol->last_eb_bytes != vol->usable_leb_size) {
810			ubi_err("bad last_eb_bytes");
811			goto fail;
812		}
813		if (vol->used_bytes != n) {
814			ubi_err("bad used_bytes");
 
 
 
 
 
815			goto fail;
816		}
817	} else {
818		if (vol->used_ebs < 0 || vol->used_ebs > vol->reserved_pebs) {
819			ubi_err("bad used_ebs");
820			goto fail;
821		}
822		if (vol->last_eb_bytes < 0 ||
823		    vol->last_eb_bytes > vol->usable_leb_size) {
824			ubi_err("bad last_eb_bytes");
825			goto fail;
826		}
827		if (vol->used_bytes < 0 || vol->used_bytes > n ||
828		    vol->used_bytes < n - vol->usable_leb_size) {
829			ubi_err("bad used_bytes");
830			goto fail;
831		}
832	}
833
834	alignment  = be32_to_cpu(ubi->vtbl[vol_id].alignment);
835	data_pad   = be32_to_cpu(ubi->vtbl[vol_id].data_pad);
836	name_len   = be16_to_cpu(ubi->vtbl[vol_id].name_len);
837	upd_marker = ubi->vtbl[vol_id].upd_marker;
838	name       = &ubi->vtbl[vol_id].name[0];
839	if (ubi->vtbl[vol_id].vol_type == UBI_VID_DYNAMIC)
840		vol_type = UBI_DYNAMIC_VOLUME;
841	else
842		vol_type = UBI_STATIC_VOLUME;
843
844	if (alignment != vol->alignment || data_pad != vol->data_pad ||
845	    upd_marker != vol->upd_marker || vol_type != vol->vol_type ||
846	    name_len != vol->name_len || strncmp(name, vol->name, name_len)) {
847		ubi_err("volume info is different");
848		goto fail;
849	}
850
851	spin_unlock(&ubi->volumes_lock);
852	return 0;
853
854fail:
855	ubi_err("paranoid check failed for volume %d", vol_id);
856	if (vol)
857		ubi_dbg_dump_vol_info(vol);
858	ubi_dbg_dump_vtbl_record(&ubi->vtbl[vol_id], vol_id);
859	dump_stack();
860	spin_unlock(&ubi->volumes_lock);
861	return -EINVAL;
862}
863
864/**
865 * paranoid_check_volumes - check information about all volumes.
866 * @ubi: UBI device description object
867 *
868 * Returns zero if volumes are all right and a a negative error code if not.
869 */
870static int paranoid_check_volumes(struct ubi_device *ubi)
871{
872	int i, err = 0;
873
874	if (!ubi->dbg->chk_gen)
875		return 0;
876
877	for (i = 0; i < ubi->vtbl_slots; i++) {
878		err = paranoid_check_volume(ubi, i);
879		if (err)
880			break;
881	}
882
883	return err;
884}
885#endif