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_PARANOID 32 static int paranoid_check_volumes(struct ubi_device *ubi); 33 #else 34 #define paranoid_check_volumes(ubi) 0 35 #endif 36 37 static 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' */ 41 static struct device_attribute attr_vol_reserved_ebs = 42 __ATTR(reserved_ebs, S_IRUGO, vol_attribute_show, NULL); 43 static struct device_attribute attr_vol_type = 44 __ATTR(type, S_IRUGO, vol_attribute_show, NULL); 45 static struct device_attribute attr_vol_name = 46 __ATTR(name, S_IRUGO, vol_attribute_show, NULL); 47 static struct device_attribute attr_vol_corrupted = 48 __ATTR(corrupted, S_IRUGO, vol_attribute_show, NULL); 49 static struct device_attribute attr_vol_alignment = 50 __ATTR(alignment, S_IRUGO, vol_attribute_show, NULL); 51 static struct device_attribute attr_vol_usable_eb_size = 52 __ATTR(usable_eb_size, S_IRUGO, vol_attribute_show, NULL); 53 static struct device_attribute attr_vol_data_bytes = 54 __ATTR(data_bytes, S_IRUGO, vol_attribute_show, NULL); 55 static 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 */ 70 static 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 */ 127 static 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 */ 147 static 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 */ 180 static 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 */ 204 int 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 err = -ENOSPC; 265 goto out_unlock; 266 } 267 ubi->avail_pebs -= vol->reserved_pebs; 268 ubi->rsvd_pebs += vol->reserved_pebs; 269 spin_unlock(&ubi->volumes_lock); 270 271 vol->vol_id = vol_id; 272 vol->alignment = req->alignment; 273 vol->data_pad = ubi->leb_size % vol->alignment; 274 vol->vol_type = req->vol_type; 275 vol->name_len = req->name_len; 276 memcpy(vol->name, req->name, vol->name_len); 277 vol->ubi = ubi; 278 279 /* 280 * Finish all pending erases because there may be some LEBs belonging 281 * to the same volume ID. 282 */ 283 err = ubi_wl_flush(ubi); 284 if (err) 285 goto out_acc; 286 287 vol->eba_tbl = kmalloc(vol->reserved_pebs * sizeof(int), GFP_KERNEL); 288 if (!vol->eba_tbl) { 289 err = -ENOMEM; 290 goto out_acc; 291 } 292 293 for (i = 0; i < vol->reserved_pebs; i++) 294 vol->eba_tbl[i] = UBI_LEB_UNMAPPED; 295 296 if (vol->vol_type == UBI_DYNAMIC_VOLUME) { 297 vol->used_ebs = vol->reserved_pebs; 298 vol->last_eb_bytes = vol->usable_leb_size; 299 vol->used_bytes = 300 (long long)vol->used_ebs * vol->usable_leb_size; 301 } else { 302 vol->used_ebs = div_u64_rem(vol->used_bytes, 303 vol->usable_leb_size, 304 &vol->last_eb_bytes); 305 if (vol->last_eb_bytes != 0) 306 vol->used_ebs += 1; 307 else 308 vol->last_eb_bytes = vol->usable_leb_size; 309 } 310 311 /* Register character device for the volume */ 312 cdev_init(&vol->cdev, &ubi_vol_cdev_operations); 313 vol->cdev.owner = THIS_MODULE; 314 dev = MKDEV(MAJOR(ubi->cdev.dev), vol_id + 1); 315 err = cdev_add(&vol->cdev, dev, 1); 316 if (err) { 317 ubi_err("cannot add character device"); 318 goto out_mapping; 319 } 320 321 vol->dev.release = vol_release; 322 vol->dev.parent = &ubi->dev; 323 vol->dev.devt = dev; 324 vol->dev.class = ubi_class; 325 326 dev_set_name(&vol->dev, "%s_%d", ubi->ubi_name, vol->vol_id); 327 err = device_register(&vol->dev); 328 if (err) { 329 ubi_err("cannot register device"); 330 goto out_cdev; 331 } 332 333 err = volume_sysfs_init(ubi, vol); 334 if (err) 335 goto out_sysfs; 336 337 /* Fill volume table record */ 338 memset(&vtbl_rec, 0, sizeof(struct ubi_vtbl_record)); 339 vtbl_rec.reserved_pebs = cpu_to_be32(vol->reserved_pebs); 340 vtbl_rec.alignment = cpu_to_be32(vol->alignment); 341 vtbl_rec.data_pad = cpu_to_be32(vol->data_pad); 342 vtbl_rec.name_len = cpu_to_be16(vol->name_len); 343 if (vol->vol_type == UBI_DYNAMIC_VOLUME) 344 vtbl_rec.vol_type = UBI_VID_DYNAMIC; 345 else 346 vtbl_rec.vol_type = UBI_VID_STATIC; 347 memcpy(vtbl_rec.name, vol->name, vol->name_len); 348 349 err = ubi_change_vtbl_record(ubi, vol_id, &vtbl_rec); 350 if (err) 351 goto out_sysfs; 352 353 spin_lock(&ubi->volumes_lock); 354 ubi->volumes[vol_id] = vol; 355 ubi->vol_count += 1; 356 spin_unlock(&ubi->volumes_lock); 357 358 ubi_volume_notify(ubi, vol, UBI_VOLUME_ADDED); 359 if (paranoid_check_volumes(ubi)) 360 dbg_err("check failed while creating volume %d", vol_id); 361 return err; 362 363 out_sysfs: 364 /* 365 * We have registered our device, we should not free the volume 366 * description object in this function in case of an error - it is 367 * freed by the release function. 368 * 369 * Get device reference to prevent the release function from being 370 * called just after sysfs has been closed. 371 */ 372 do_free = 0; 373 get_device(&vol->dev); 374 volume_sysfs_close(vol); 375 out_cdev: 376 cdev_del(&vol->cdev); 377 out_mapping: 378 if (do_free) 379 kfree(vol->eba_tbl); 380 out_acc: 381 spin_lock(&ubi->volumes_lock); 382 ubi->rsvd_pebs -= vol->reserved_pebs; 383 ubi->avail_pebs += vol->reserved_pebs; 384 out_unlock: 385 spin_unlock(&ubi->volumes_lock); 386 if (do_free) 387 kfree(vol); 388 else 389 put_device(&vol->dev); 390 ubi_err("cannot create volume %d, error %d", vol_id, err); 391 return err; 392 } 393 394 /** 395 * ubi_remove_volume - remove volume. 396 * @desc: volume descriptor 397 * @no_vtbl: do not change volume table if not zero 398 * 399 * This function removes volume described by @desc. The volume has to be opened 400 * in "exclusive" mode. Returns zero in case of success and a negative error 401 * code in case of failure. The caller has to have the @ubi->device_mutex 402 * locked. 403 */ 404 int ubi_remove_volume(struct ubi_volume_desc *desc, int no_vtbl) 405 { 406 struct ubi_volume *vol = desc->vol; 407 struct ubi_device *ubi = vol->ubi; 408 int i, err, vol_id = vol->vol_id, reserved_pebs = vol->reserved_pebs; 409 410 dbg_gen("remove device %d, volume %d", ubi->ubi_num, vol_id); 411 ubi_assert(desc->mode == UBI_EXCLUSIVE); 412 ubi_assert(vol == ubi->volumes[vol_id]); 413 414 if (ubi->ro_mode) 415 return -EROFS; 416 417 spin_lock(&ubi->volumes_lock); 418 if (vol->ref_count > 1) { 419 /* 420 * The volume is busy, probably someone is reading one of its 421 * sysfs files. 422 */ 423 err = -EBUSY; 424 goto out_unlock; 425 } 426 ubi->volumes[vol_id] = NULL; 427 spin_unlock(&ubi->volumes_lock); 428 429 if (!no_vtbl) { 430 err = ubi_change_vtbl_record(ubi, vol_id, NULL); 431 if (err) 432 goto out_err; 433 } 434 435 for (i = 0; i < vol->reserved_pebs; i++) { 436 err = ubi_eba_unmap_leb(ubi, vol, i); 437 if (err) 438 goto out_err; 439 } 440 441 cdev_del(&vol->cdev); 442 volume_sysfs_close(vol); 443 444 spin_lock(&ubi->volumes_lock); 445 ubi->rsvd_pebs -= reserved_pebs; 446 ubi->avail_pebs += reserved_pebs; 447 i = ubi->beb_rsvd_level - ubi->beb_rsvd_pebs; 448 if (i > 0) { 449 i = ubi->avail_pebs >= i ? i : ubi->avail_pebs; 450 ubi->avail_pebs -= i; 451 ubi->rsvd_pebs += i; 452 ubi->beb_rsvd_pebs += i; 453 if (i > 0) 454 ubi_msg("reserve more %d PEBs", i); 455 } 456 ubi->vol_count -= 1; 457 spin_unlock(&ubi->volumes_lock); 458 459 ubi_volume_notify(ubi, vol, UBI_VOLUME_REMOVED); 460 if (!no_vtbl && paranoid_check_volumes(ubi)) 461 dbg_err("check failed while removing volume %d", vol_id); 462 463 return err; 464 465 out_err: 466 ubi_err("cannot remove volume %d, error %d", vol_id, err); 467 spin_lock(&ubi->volumes_lock); 468 ubi->volumes[vol_id] = vol; 469 out_unlock: 470 spin_unlock(&ubi->volumes_lock); 471 return err; 472 } 473 474 /** 475 * ubi_resize_volume - re-size volume. 476 * @desc: volume descriptor 477 * @reserved_pebs: new size in physical eraseblocks 478 * 479 * This function re-sizes the volume and returns zero in case of success, and a 480 * negative error code in case of failure. The caller has to have the 481 * @ubi->device_mutex locked. 482 */ 483 int ubi_resize_volume(struct ubi_volume_desc *desc, int reserved_pebs) 484 { 485 int i, err, pebs, *new_mapping; 486 struct ubi_volume *vol = desc->vol; 487 struct ubi_device *ubi = vol->ubi; 488 struct ubi_vtbl_record vtbl_rec; 489 int vol_id = vol->vol_id; 490 491 if (ubi->ro_mode) 492 return -EROFS; 493 494 dbg_gen("re-size device %d, volume %d to from %d to %d PEBs", 495 ubi->ubi_num, vol_id, vol->reserved_pebs, reserved_pebs); 496 497 if (vol->vol_type == UBI_STATIC_VOLUME && 498 reserved_pebs < vol->used_ebs) { 499 dbg_err("too small size %d, %d LEBs contain data", 500 reserved_pebs, vol->used_ebs); 501 return -EINVAL; 502 } 503 504 /* If the size is the same, we have nothing to do */ 505 if (reserved_pebs == vol->reserved_pebs) 506 return 0; 507 508 new_mapping = kmalloc(reserved_pebs * sizeof(int), GFP_KERNEL); 509 if (!new_mapping) 510 return -ENOMEM; 511 512 for (i = 0; i < reserved_pebs; i++) 513 new_mapping[i] = UBI_LEB_UNMAPPED; 514 515 spin_lock(&ubi->volumes_lock); 516 if (vol->ref_count > 1) { 517 spin_unlock(&ubi->volumes_lock); 518 err = -EBUSY; 519 goto out_free; 520 } 521 spin_unlock(&ubi->volumes_lock); 522 523 /* Reserve physical eraseblocks */ 524 pebs = reserved_pebs - vol->reserved_pebs; 525 if (pebs > 0) { 526 spin_lock(&ubi->volumes_lock); 527 if (pebs > ubi->avail_pebs) { 528 dbg_err("not enough PEBs: requested %d, available %d", 529 pebs, ubi->avail_pebs); 530 spin_unlock(&ubi->volumes_lock); 531 err = -ENOSPC; 532 goto out_free; 533 } 534 ubi->avail_pebs -= pebs; 535 ubi->rsvd_pebs += pebs; 536 for (i = 0; i < vol->reserved_pebs; i++) 537 new_mapping[i] = vol->eba_tbl[i]; 538 kfree(vol->eba_tbl); 539 vol->eba_tbl = new_mapping; 540 spin_unlock(&ubi->volumes_lock); 541 } 542 543 /* Change volume table record */ 544 memcpy(&vtbl_rec, &ubi->vtbl[vol_id], sizeof(struct ubi_vtbl_record)); 545 vtbl_rec.reserved_pebs = cpu_to_be32(reserved_pebs); 546 err = ubi_change_vtbl_record(ubi, vol_id, &vtbl_rec); 547 if (err) 548 goto out_acc; 549 550 if (pebs < 0) { 551 for (i = 0; i < -pebs; i++) { 552 err = ubi_eba_unmap_leb(ubi, vol, reserved_pebs + i); 553 if (err) 554 goto out_acc; 555 } 556 spin_lock(&ubi->volumes_lock); 557 ubi->rsvd_pebs += pebs; 558 ubi->avail_pebs -= pebs; 559 pebs = ubi->beb_rsvd_level - ubi->beb_rsvd_pebs; 560 if (pebs > 0) { 561 pebs = ubi->avail_pebs >= pebs ? pebs : ubi->avail_pebs; 562 ubi->avail_pebs -= pebs; 563 ubi->rsvd_pebs += pebs; 564 ubi->beb_rsvd_pebs += pebs; 565 if (pebs > 0) 566 ubi_msg("reserve more %d PEBs", pebs); 567 } 568 for (i = 0; i < reserved_pebs; i++) 569 new_mapping[i] = vol->eba_tbl[i]; 570 kfree(vol->eba_tbl); 571 vol->eba_tbl = new_mapping; 572 spin_unlock(&ubi->volumes_lock); 573 } 574 575 vol->reserved_pebs = reserved_pebs; 576 if (vol->vol_type == UBI_DYNAMIC_VOLUME) { 577 vol->used_ebs = reserved_pebs; 578 vol->last_eb_bytes = vol->usable_leb_size; 579 vol->used_bytes = 580 (long long)vol->used_ebs * vol->usable_leb_size; 581 } 582 583 ubi_volume_notify(ubi, vol, UBI_VOLUME_RESIZED); 584 if (paranoid_check_volumes(ubi)) 585 dbg_err("check failed while re-sizing volume %d", vol_id); 586 return err; 587 588 out_acc: 589 if (pebs > 0) { 590 spin_lock(&ubi->volumes_lock); 591 ubi->rsvd_pebs -= pebs; 592 ubi->avail_pebs += pebs; 593 spin_unlock(&ubi->volumes_lock); 594 } 595 out_free: 596 kfree(new_mapping); 597 return err; 598 } 599 600 /** 601 * ubi_rename_volumes - re-name UBI volumes. 602 * @ubi: UBI device description object 603 * @rename_list: list of &struct ubi_rename_entry objects 604 * 605 * This function re-names or removes volumes specified in the re-name list. 606 * Returns zero in case of success and a negative error code in case of 607 * failure. 608 */ 609 int ubi_rename_volumes(struct ubi_device *ubi, struct list_head *rename_list) 610 { 611 int err; 612 struct ubi_rename_entry *re; 613 614 err = ubi_vtbl_rename_volumes(ubi, rename_list); 615 if (err) 616 return err; 617 618 list_for_each_entry(re, rename_list, list) { 619 if (re->remove) { 620 err = ubi_remove_volume(re->desc, 1); 621 if (err) 622 break; 623 } else { 624 struct ubi_volume *vol = re->desc->vol; 625 626 spin_lock(&ubi->volumes_lock); 627 vol->name_len = re->new_name_len; 628 memcpy(vol->name, re->new_name, re->new_name_len + 1); 629 spin_unlock(&ubi->volumes_lock); 630 ubi_volume_notify(ubi, vol, UBI_VOLUME_RENAMED); 631 } 632 } 633 634 if (!err && paranoid_check_volumes(ubi)) 635 ; 636 return err; 637 } 638 639 /** 640 * ubi_add_volume - add volume. 641 * @ubi: UBI device description object 642 * @vol: volume description object 643 * 644 * This function adds an existing volume and initializes all its data 645 * structures. Returns zero in case of success and a negative error code in 646 * case of failure. 647 */ 648 int ubi_add_volume(struct ubi_device *ubi, struct ubi_volume *vol) 649 { 650 int err, vol_id = vol->vol_id; 651 dev_t dev; 652 653 dbg_gen("add volume %d", vol_id); 654 655 /* Register character device for the volume */ 656 cdev_init(&vol->cdev, &ubi_vol_cdev_operations); 657 vol->cdev.owner = THIS_MODULE; 658 dev = MKDEV(MAJOR(ubi->cdev.dev), vol->vol_id + 1); 659 err = cdev_add(&vol->cdev, dev, 1); 660 if (err) { 661 ubi_err("cannot add character device for volume %d, error %d", 662 vol_id, err); 663 return err; 664 } 665 666 vol->dev.release = vol_release; 667 vol->dev.parent = &ubi->dev; 668 vol->dev.devt = dev; 669 vol->dev.class = ubi_class; 670 dev_set_name(&vol->dev, "%s_%d", ubi->ubi_name, vol->vol_id); 671 err = device_register(&vol->dev); 672 if (err) 673 goto out_cdev; 674 675 err = volume_sysfs_init(ubi, vol); 676 if (err) { 677 cdev_del(&vol->cdev); 678 volume_sysfs_close(vol); 679 return err; 680 } 681 682 if (paranoid_check_volumes(ubi)) 683 dbg_err("check failed while adding volume %d", vol_id); 684 return err; 685 686 out_cdev: 687 cdev_del(&vol->cdev); 688 return err; 689 } 690 691 /** 692 * ubi_free_volume - free volume. 693 * @ubi: UBI device description object 694 * @vol: volume description object 695 * 696 * This function frees all resources for volume @vol but does not remove it. 697 * Used only when the UBI device is detached. 698 */ 699 void ubi_free_volume(struct ubi_device *ubi, struct ubi_volume *vol) 700 { 701 dbg_gen("free volume %d", vol->vol_id); 702 703 ubi->volumes[vol->vol_id] = NULL; 704 cdev_del(&vol->cdev); 705 volume_sysfs_close(vol); 706 } 707 708 #ifdef CONFIG_MTD_UBI_DEBUG_PARANOID 709 710 /** 711 * paranoid_check_volume - check volume information. 712 * @ubi: UBI device description object 713 * @vol_id: volume ID 714 * 715 * Returns zero if volume is all right and a a negative error code if not. 716 */ 717 static int paranoid_check_volume(struct ubi_device *ubi, int vol_id) 718 { 719 int idx = vol_id2idx(ubi, vol_id); 720 int reserved_pebs, alignment, data_pad, vol_type, name_len, upd_marker; 721 const struct ubi_volume *vol; 722 long long n; 723 const char *name; 724 725 spin_lock(&ubi->volumes_lock); 726 reserved_pebs = be32_to_cpu(ubi->vtbl[vol_id].reserved_pebs); 727 vol = ubi->volumes[idx]; 728 729 if (!vol) { 730 if (reserved_pebs) { 731 ubi_err("no volume info, but volume exists"); 732 goto fail; 733 } 734 spin_unlock(&ubi->volumes_lock); 735 return 0; 736 } 737 738 if (vol->reserved_pebs < 0 || vol->alignment < 0 || vol->data_pad < 0 || 739 vol->name_len < 0) { 740 ubi_err("negative values"); 741 goto fail; 742 } 743 if (vol->alignment > ubi->leb_size || vol->alignment == 0) { 744 ubi_err("bad alignment"); 745 goto fail; 746 } 747 748 n = vol->alignment & (ubi->min_io_size - 1); 749 if (vol->alignment != 1 && n) { 750 ubi_err("alignment is not multiple of min I/O unit"); 751 goto fail; 752 } 753 754 n = ubi->leb_size % vol->alignment; 755 if (vol->data_pad != n) { 756 ubi_err("bad data_pad, has to be %lld", n); 757 goto fail; 758 } 759 760 if (vol->vol_type != UBI_DYNAMIC_VOLUME && 761 vol->vol_type != UBI_STATIC_VOLUME) { 762 ubi_err("bad vol_type"); 763 goto fail; 764 } 765 766 if (vol->upd_marker && vol->corrupted) { 767 dbg_err("update marker and corrupted simultaneously"); 768 goto fail; 769 } 770 771 if (vol->reserved_pebs > ubi->good_peb_count) { 772 ubi_err("too large reserved_pebs"); 773 goto fail; 774 } 775 776 n = ubi->leb_size - vol->data_pad; 777 if (vol->usable_leb_size != ubi->leb_size - vol->data_pad) { 778 ubi_err("bad usable_leb_size, has to be %lld", n); 779 goto fail; 780 } 781 782 if (vol->name_len > UBI_VOL_NAME_MAX) { 783 ubi_err("too long volume name, max is %d", UBI_VOL_NAME_MAX); 784 goto fail; 785 } 786 787 if (!vol->name) { 788 ubi_err("NULL volume name"); 789 goto fail; 790 } 791 792 n = strnlen(vol->name, vol->name_len + 1); 793 if (n != vol->name_len) { 794 ubi_err("bad name_len %lld", n); 795 goto fail; 796 } 797 798 n = (long long)vol->used_ebs * vol->usable_leb_size; 799 if (vol->vol_type == UBI_DYNAMIC_VOLUME) { 800 if (vol->corrupted) { 801 ubi_err("corrupted dynamic volume"); 802 goto fail; 803 } 804 if (vol->used_ebs != vol->reserved_pebs) { 805 ubi_err("bad used_ebs"); 806 goto fail; 807 } 808 if (vol->last_eb_bytes != vol->usable_leb_size) { 809 ubi_err("bad last_eb_bytes"); 810 goto fail; 811 } 812 if (vol->used_bytes != n) { 813 ubi_err("bad used_bytes"); 814 goto fail; 815 } 816 } else { 817 if (vol->used_ebs < 0 || vol->used_ebs > vol->reserved_pebs) { 818 ubi_err("bad used_ebs"); 819 goto fail; 820 } 821 if (vol->last_eb_bytes < 0 || 822 vol->last_eb_bytes > vol->usable_leb_size) { 823 ubi_err("bad last_eb_bytes"); 824 goto fail; 825 } 826 if (vol->used_bytes < 0 || vol->used_bytes > n || 827 vol->used_bytes < n - vol->usable_leb_size) { 828 ubi_err("bad used_bytes"); 829 goto fail; 830 } 831 } 832 833 alignment = be32_to_cpu(ubi->vtbl[vol_id].alignment); 834 data_pad = be32_to_cpu(ubi->vtbl[vol_id].data_pad); 835 name_len = be16_to_cpu(ubi->vtbl[vol_id].name_len); 836 upd_marker = ubi->vtbl[vol_id].upd_marker; 837 name = &ubi->vtbl[vol_id].name[0]; 838 if (ubi->vtbl[vol_id].vol_type == UBI_VID_DYNAMIC) 839 vol_type = UBI_DYNAMIC_VOLUME; 840 else 841 vol_type = UBI_STATIC_VOLUME; 842 843 if (alignment != vol->alignment || data_pad != vol->data_pad || 844 upd_marker != vol->upd_marker || vol_type != vol->vol_type || 845 name_len != vol->name_len || strncmp(name, vol->name, name_len)) { 846 ubi_err("volume info is different"); 847 goto fail; 848 } 849 850 spin_unlock(&ubi->volumes_lock); 851 return 0; 852 853 fail: 854 ubi_err("paranoid check failed for volume %d", vol_id); 855 if (vol) 856 ubi_dbg_dump_vol_info(vol); 857 ubi_dbg_dump_vtbl_record(&ubi->vtbl[vol_id], vol_id); 858 dump_stack(); 859 spin_unlock(&ubi->volumes_lock); 860 return -EINVAL; 861 } 862 863 /** 864 * paranoid_check_volumes - check information about all volumes. 865 * @ubi: UBI device description object 866 * 867 * Returns zero if volumes are all right and a a negative error code if not. 868 */ 869 static int paranoid_check_volumes(struct ubi_device *ubi) 870 { 871 int i, err = 0; 872 873 for (i = 0; i < ubi->vtbl_slots; i++) { 874 err = paranoid_check_volume(ubi, i); 875 if (err) 876 break; 877 } 878 879 return err; 880 } 881 #endif 882