drivers/mtd/ubi/cdev.c

   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 includes implementation of UBI character device operations.
  23  *
  24  * There are two kinds of character devices in UBI: UBI character devices and
  25  * UBI volume character devices. UBI character devices allow users to
  26  * manipulate whole volumes: create, remove, and re-size them. Volume character
  27  * devices provide volume I/O capabilities.
  28  *
  29  * Major and minor numbers are assigned dynamically to both UBI and volume
  30  * character devices.
  31  */
  32
  33 #include <linux/module.h>
  34 #include <linux/stat.h>
  35 #include <linux/ioctl.h>
  36 #include <linux/capability.h>
  37 #include <mtd/ubi-user.h>
  38 #include <asm/uaccess.h>
  39 #include <asm/div64.h>
  40 #include "ubi.h"
  41
  42 /*
  43  * Maximum sequence numbers of UBI and volume character device IOCTLs (direct
  44  * logical eraseblock erase is a debug-only feature).
  45  */
  46 #define UBI_CDEV_IOC_MAX_SEQ 2
  47 #ifndef CONFIG_MTD_UBI_DEBUG_USERSPACE_IO
  48 #define VOL_CDEV_IOC_MAX_SEQ 1
  49 #else
  50 #define VOL_CDEV_IOC_MAX_SEQ 2
  51 #endif
  52
  53 /**
  54  * major_to_device - get UBI device object by character device major number.
  55  * @major: major number
  56  *
  57  * This function returns a pointer to the UBI device object.
  58  */
  59 static struct ubi_device *major_to_device(int major)
  60 {
  61         int i;
  62
  63         for (i = 0; i < ubi_devices_cnt; i++)
  64                 if (ubi_devices[i] && ubi_devices[i]->major == major)
  65                         return ubi_devices[i];
  66         BUG();
  67 }
  68
  69 /**
  70  * get_exclusive - get exclusive access to an UBI volume.
  71  * @desc: volume descriptor
  72  *
  73  * This function changes UBI volume open mode to "exclusive". Returns previous
  74  * mode value (positive integer) in case of success and a negative error code
  75  * in case of failure.
  76  */
  77 static int get_exclusive(struct ubi_volume_desc *desc)
  78 {
  79         int users, err;
  80         struct ubi_volume *vol = desc->vol;
  81
  82         spin_lock(&vol->ubi->volumes_lock);
  83         users = vol->readers + vol->writers + vol->exclusive;
  84         ubi_assert(users > 0);
  85         if (users > 1) {
  86                 dbg_err("%d users for volume %d", users, vol->vol_id);
  87                 err = -EBUSY;
  88         } else {
  89                 vol->readers = vol->writers = 0;
  90                 vol->exclusive = 1;
  91                 err = desc->mode;
  92                 desc->mode = UBI_EXCLUSIVE;
  93         }
  94         spin_unlock(&vol->ubi->volumes_lock);
  95
  96         return err;
  97 }
  98
  99 /**
 100  * revoke_exclusive - revoke exclusive mode.
 101  * @desc: volume descriptor
 102  * @mode: new mode to switch to
 103  */
 104 static void revoke_exclusive(struct ubi_volume_desc *desc, int mode)
 105 {
 106         struct ubi_volume *vol = desc->vol;
 107
 108         spin_lock(&vol->ubi->volumes_lock);
 109         ubi_assert(vol->readers == 0 && vol->writers == 0);
 110         ubi_assert(vol->exclusive == 1 && desc->mode == UBI_EXCLUSIVE);
 111         vol->exclusive = 0;
 112         if (mode == UBI_READONLY)
 113                 vol->readers = 1;
 114         else if (mode == UBI_READWRITE)
 115                 vol->writers = 1;
 116         else
 117                 vol->exclusive = 1;
 118         spin_unlock(&vol->ubi->volumes_lock);
 119
 120         desc->mode = mode;
 121 }
 122
 123 static int vol_cdev_open(struct inode *inode, struct file *file)
 124 {
 125         struct ubi_volume_desc *desc;
 126         const struct ubi_device *ubi = major_to_device(imajor(inode));
 127         int vol_id = iminor(inode) - 1;
 128         int mode;
 129
 130         if (file->f_mode & FMODE_WRITE)
 131                 mode = UBI_READWRITE;
 132         else
 133                 mode = UBI_READONLY;
 134
 135         dbg_msg("open volume %d, mode %d", vol_id, mode);
 136
 137         desc = ubi_open_volume(ubi->ubi_num, vol_id, mode);
 138         if (IS_ERR(desc))
 139                 return PTR_ERR(desc);
 140
 141         file->private_data = desc;
 142         return 0;
 143 }
 144
 145 static int vol_cdev_release(struct inode *inode, struct file *file)
 146 {
 147         struct ubi_volume_desc *desc = file->private_data;
 148         struct ubi_volume *vol = desc->vol;
 149
 150         dbg_msg("release volume %d, mode %d", vol->vol_id, desc->mode);
 151
 152         if (vol->updating) {
 153                 ubi_warn("update of volume %d not finished, volume is damaged",
 154                          vol->vol_id);
 155                 vol->updating = 0;
 156                 vfree(vol->upd_buf);
 157         }
 158
 159         ubi_close_volume(desc);
 160         return 0;
 161 }
 162
 163 static loff_t vol_cdev_llseek(struct file *file, loff_t offset, int origin)
 164 {
 165         struct ubi_volume_desc *desc = file->private_data;
 166         struct ubi_volume *vol = desc->vol;
 167         loff_t new_offset;
 168
 169         if (vol->updating) {
 170                  /* Update is in progress, seeking is prohibited */
 171                 dbg_err("updating");
 172                 return -EBUSY;
 173         }
 174
 175         switch (origin) {
 176         case 0: /* SEEK_SET */
 177                 new_offset = offset;
 178                 break;
 179         case 1: /* SEEK_CUR */
 180                 new_offset = file->f_pos + offset;
 181                 break;
 182         case 2: /* SEEK_END */
 183                 new_offset = vol->used_bytes + offset;
 184                 break;
 185         default:
 186                 return -EINVAL;
 187         }
 188
 189         if (new_offset < 0 || new_offset > vol->used_bytes) {
 190                 dbg_err("bad seek %lld", new_offset);
 191                 return -EINVAL;
 192         }
 193
 194         dbg_msg("seek volume %d, offset %lld, origin %d, new offset %lld",
 195                 vol->vol_id, offset, origin, new_offset);
 196
 197         file->f_pos = new_offset;
 198         return new_offset;
 199 }
 200
 201 static ssize_t vol_cdev_read(struct file *file, __user char *buf, size_t count,
 202                              loff_t *offp)
 203 {
 204         struct ubi_volume_desc *desc = file->private_data;
 205         struct ubi_volume *vol = desc->vol;
 206         struct ubi_device *ubi = vol->ubi;
 207         int err, lnum, off, len,  vol_id = desc->vol->vol_id, tbuf_size;
 208         size_t count_save = count;
 209         void *tbuf;
 210         uint64_t tmp;
 211
 212         dbg_msg("read %zd bytes from offset %lld of volume %d",
 213                 count, *offp, vol_id);
 214
 215         if (vol->updating) {
 216                 dbg_err("updating");
 217                 return -EBUSY;
 218         }
 219         if (vol->upd_marker) {
 220                 dbg_err("damaged volume, update marker is set");
 221                 return -EBADF;
 222         }
 223         if (*offp == vol->used_bytes || count == 0)
 224                 return 0;
 225
 226         if (vol->corrupted)
 227                 dbg_msg("read from corrupted volume %d", vol_id);
 228
 229         if (*offp + count > vol->used_bytes)
 230                 count_save = count = vol->used_bytes - *offp;
 231
 232         tbuf_size = vol->usable_leb_size;
 233         if (count < tbuf_size)
 234                 tbuf_size = ALIGN(count, ubi->min_io_size);
 235         tbuf = vmalloc(tbuf_size);
 236         if (!tbuf)
 237                 return -ENOMEM;
 238
 239         len = count > tbuf_size ? tbuf_size : count;
 240
 241         tmp = *offp;
 242         off = do_div(tmp, vol->usable_leb_size);
 243         lnum = tmp;
 244
 245         do {
 246                 cond_resched();
 247
 248                 if (off + len >= vol->usable_leb_size)
 249                         len = vol->usable_leb_size - off;
 250
 251                 err = ubi_eba_read_leb(ubi, vol_id, lnum, tbuf, off, len, 0);
 252                 if (err)
 253                         break;
 254
 255                 off += len;
 256                 if (off == vol->usable_leb_size) {
 257                         lnum += 1;
 258                         off -= vol->usable_leb_size;
 259                 }
 260
 261                 count -= len;
 262                 *offp += len;
 263
 264                 err = copy_to_user(buf, tbuf, len);
 265                 if (err) {
 266                         err = -EFAULT;
 267                         break;
 268                 }
 269
 270                 buf += len;
 271                 len = count > tbuf_size ? tbuf_size : count;
 272         } while (count);
 273
 274         vfree(tbuf);
 275         return err ? err : count_save - count;
 276 }
 277
 278 #ifdef CONFIG_MTD_UBI_DEBUG_USERSPACE_IO
 279
 280 /*
 281  * This function allows to directly write to dynamic UBI volumes, without
 282  * issuing the volume update operation. Available only as a debugging feature.
 283  * Very useful for testing UBI.
 284  */
 285 static ssize_t vol_cdev_direct_write(struct file *file, const char __user *buf,
 286                                      size_t count, loff_t *offp)
 287 {
 288         struct ubi_volume_desc *desc = file->private_data;
 289         struct ubi_volume *vol = desc->vol;
 290         struct ubi_device *ubi = vol->ubi;
 291         int lnum, off, len, tbuf_size, vol_id = vol->vol_id, err = 0;
 292         size_t count_save = count;
 293         char *tbuf;
 294         uint64_t tmp;
 295
 296         dbg_msg("requested: write %zd bytes to offset %lld of volume %u",
 297                 count, *offp, desc->vol->vol_id);
 298
 299         if (vol->vol_type == UBI_STATIC_VOLUME)
 300                 return -EROFS;
 301
 302         tmp = *offp;
 303         off = do_div(tmp, vol->usable_leb_size);
 304         lnum = tmp;
 305
 306         if (off % ubi->min_io_size) {
 307                 dbg_err("unaligned position");
 308                 return -EINVAL;
 309         }
 310
 311         if (*offp + count > vol->used_bytes)
 312                 count_save = count = vol->used_bytes - *offp;
 313
 314         /* We can write only in fractions of the minimum I/O unit */
 315         if (count % ubi->min_io_size) {
 316                 dbg_err("unaligned write length");
 317                 return -EINVAL;
 318         }
 319
 320         tbuf_size = vol->usable_leb_size;
 321         if (count < tbuf_size)
 322                 tbuf_size = ALIGN(count, ubi->min_io_size);
 323         tbuf = vmalloc(tbuf_size);
 324         if (!tbuf)
 325                 return -ENOMEM;
 326
 327         len = count > tbuf_size ? tbuf_size : count;
 328
 329         while (count) {
 330                 cond_resched();
 331
 332                 if (off + len >= vol->usable_leb_size)
 333                         len = vol->usable_leb_size - off;
 334
 335                 err = copy_from_user(tbuf, buf, len);
 336                 if (err) {
 337                         err = -EFAULT;
 338                         break;
 339                 }
 340
 341                 err = ubi_eba_write_leb(ubi, vol_id, lnum, tbuf, off, len,
 342                                         UBI_UNKNOWN);
 343                 if (err)
 344                         break;
 345
 346                 off += len;
 347                 if (off == vol->usable_leb_size) {
 348                         lnum += 1;
 349                         off -= vol->usable_leb_size;
 350                 }
 351
 352                 count -= len;
 353                 *offp += len;
 354                 buf += len;
 355                 len = count > tbuf_size ? tbuf_size : count;
 356         }
 357
 358         vfree(tbuf);
 359         return err ? err : count_save - count;
 360 }
 361
 362 #else
 363 #define vol_cdev_direct_write(file, buf, count, offp) -EPERM
 364 #endif /* CONFIG_MTD_UBI_DEBUG_USERSPACE_IO */
 365
 366 static ssize_t vol_cdev_write(struct file *file, const char __user *buf,
 367                               size_t count, loff_t *offp)
 368 {
 369         int err = 0;
 370         struct ubi_volume_desc *desc = file->private_data;
 371         struct ubi_volume *vol = desc->vol;
 372         struct ubi_device *ubi = vol->ubi;
 373
 374         if (!vol->updating)
 375                 return vol_cdev_direct_write(file, buf, count, offp);
 376
 377         err = ubi_more_update_data(ubi, vol->vol_id, buf, count);
 378         if (err < 0) {
 379                 ubi_err("cannot write %zd bytes of update data", count);
 380                 return err;
 381         }
 382
 383         if (err) {
 384                 /*
 385                  * Update is finished, @err contains number of actually written
 386                  * bytes now.
 387                  */
 388                 count = err;
 389
 390                 err = ubi_check_volume(ubi, vol->vol_id);
 391                 if (err < 0)
 392                         return err;
 393
 394                 if (err) {
 395                         ubi_warn("volume %d on UBI device %d is corrupted",
 396                                  vol->vol_id, ubi->ubi_num);
 397                         vol->corrupted = 1;
 398                 }
 399                 vol->checked = 1;
 400                 ubi_gluebi_updated(vol);
 401                 revoke_exclusive(desc, UBI_READWRITE);
 402         }
 403
 404         *offp += count;
 405         return count;
 406 }
 407
 408 static int vol_cdev_ioctl(struct inode *inode, struct file *file,
 409                           unsigned int cmd, unsigned long arg)
 410 {
 411         int err = 0;
 412         struct ubi_volume_desc *desc = file->private_data;
 413         struct ubi_volume *vol = desc->vol;
 414         struct ubi_device *ubi = vol->ubi;
 415         void __user *argp = (void __user *)arg;
 416
 417         if (_IOC_NR(cmd) > VOL_CDEV_IOC_MAX_SEQ ||
 418             _IOC_TYPE(cmd) != UBI_VOL_IOC_MAGIC)
 419                 return -ENOTTY;
 420
 421         if (_IOC_DIR(cmd) && _IOC_READ)
 422                 err = !access_ok(VERIFY_WRITE, argp, _IOC_SIZE(cmd));
 423         else if (_IOC_DIR(cmd) && _IOC_WRITE)
 424                 err = !access_ok(VERIFY_READ, argp, _IOC_SIZE(cmd));
 425         if (err)
 426                 return -EFAULT;
 427
 428         switch (cmd) {
 429
 430         /* Volume update command */
 431         case UBI_IOCVOLUP:
 432         {
 433                 int64_t bytes, rsvd_bytes;
 434
 435                 if (!capable(CAP_SYS_RESOURCE)) {
 436                         err = -EPERM;
 437                         break;
 438                 }
 439
 440                 err = copy_from_user(&bytes, argp, sizeof(int64_t));
 441                 if (err) {
 442                         err = -EFAULT;
 443                         break;
 444                 }
 445
 446                 if (desc->mode == UBI_READONLY) {
 447                         err = -EROFS;
 448                         break;
 449                 }
 450
 451                 rsvd_bytes = vol->reserved_pebs * (ubi->leb_size-vol->data_pad);
 452                 if (bytes < 0 || bytes > rsvd_bytes) {
 453                         err = -EINVAL;
 454                         break;
 455                 }
 456
 457                 err = get_exclusive(desc);
 458                 if (err < 0)
 459                         break;
 460
 461                 err = ubi_start_update(ubi, vol->vol_id, bytes);
 462                 if (bytes == 0)
 463                         revoke_exclusive(desc, UBI_READWRITE);
 464
 465                 file->f_pos = 0;
 466                 break;
 467         }
 468
 469 #ifdef CONFIG_MTD_UBI_DEBUG_USERSPACE_IO
 470         /* Logical eraseblock erasure command */
 471         case UBI_IOCEBER:
 472         {
 473                 int32_t lnum;
 474
 475                 err = __get_user(lnum, (__user int32_t *)argp);
 476                 if (err) {
 477                         err = -EFAULT;
 478                         break;
 479                 }
 480
 481                 if (desc->mode == UBI_READONLY) {
 482                         err = -EROFS;
 483                         break;
 484                 }
 485
 486                 if (lnum < 0 || lnum >= vol->reserved_pebs) {
 487                         err = -EINVAL;
 488                         break;
 489                 }
 490
 491                 if (vol->vol_type != UBI_DYNAMIC_VOLUME) {
 492                         err = -EROFS;
 493                         break;
 494                 }
 495
 496                 dbg_msg("erase LEB %d:%d", vol->vol_id, lnum);
 497                 err = ubi_eba_unmap_leb(ubi, vol->vol_id, lnum);
 498                 if (err)
 499                         break;
 500
 501                 err = ubi_wl_flush(ubi);
 502                 break;
 503         }
 504 #endif
 505
 506         default:
 507                 err = -ENOTTY;
 508                 break;
 509         }
 510
 511         return err;
 512 }
 513
 514 /**
 515  * verify_mkvol_req - verify volume creation request.
 516  * @ubi: UBI device description object
 517  * @req: the request to check
 518  *
 519  * This function zero if the request is correct, and %-EINVAL if not.
 520  */
 521 static int verify_mkvol_req(const struct ubi_device *ubi,
 522                             const struct ubi_mkvol_req *req)
 523 {
 524         int n, err = -EINVAL;
 525
 526         if (req->bytes < 0 || req->alignment < 0 || req->vol_type < 0 ||
 527             req->name_len < 0)
 528                 goto bad;
 529
 530         if ((req->vol_id < 0 || req->vol_id >= ubi->vtbl_slots) &&
 531             req->vol_id != UBI_VOL_NUM_AUTO)
 532                 goto bad;
 533
 534         if (req->alignment == 0)
 535                 goto bad;
 536
 537         if (req->bytes == 0)
 538                 goto bad;
 539
 540         if (req->vol_type != UBI_DYNAMIC_VOLUME &&
 541             req->vol_type != UBI_STATIC_VOLUME)
 542                 goto bad;
 543
 544         if (req->alignment > ubi->leb_size)
 545                 goto bad;
 546
 547         n = req->alignment % ubi->min_io_size;
 548         if (req->alignment != 1 && n)
 549                 goto bad;
 550
 551         if (req->name_len > UBI_VOL_NAME_MAX) {
 552                 err = -ENAMETOOLONG;
 553                 goto bad;
 554         }
 555
 556         return 0;
 557
 558 bad:
 559         dbg_err("bad volume creation request");
 560         ubi_dbg_dump_mkvol_req(req);
 561         return err;
 562 }
 563
 564 /**
 565  * verify_rsvol_req - verify volume re-size request.
 566  * @ubi: UBI device description object
 567  * @req: the request to check
 568  *
 569  * This function returns zero if the request is correct, and %-EINVAL if not.
 570  */
 571 static int verify_rsvol_req(const struct ubi_device *ubi,
 572                             const struct ubi_rsvol_req *req)
 573 {
 574         if (req->bytes <= 0)
 575                 return -EINVAL;
 576
 577         if (req->vol_id < 0 || req->vol_id >= ubi->vtbl_slots)
 578                 return -EINVAL;
 579
 580         return 0;
 581 }
 582
 583 static int ubi_cdev_ioctl(struct inode *inode, struct file *file,
 584                           unsigned int cmd, unsigned long arg)
 585 {
 586         int err = 0;
 587         struct ubi_device *ubi;
 588         struct ubi_volume_desc *desc;
 589         void __user *argp = (void __user *)arg;
 590
 591         if (_IOC_NR(cmd) > UBI_CDEV_IOC_MAX_SEQ ||
 592             _IOC_TYPE(cmd) != UBI_IOC_MAGIC)
 593                 return -ENOTTY;
 594
 595         if (_IOC_DIR(cmd) && _IOC_READ)
 596                 err = !access_ok(VERIFY_WRITE, argp, _IOC_SIZE(cmd));
 597         else if (_IOC_DIR(cmd) && _IOC_WRITE)
 598                 err = !access_ok(VERIFY_READ, argp, _IOC_SIZE(cmd));
 599         if (err)
 600                 return -EFAULT;
 601
 602         if (!capable(CAP_SYS_RESOURCE))
 603                 return -EPERM;
 604
 605         ubi = major_to_device(imajor(inode));
 606         if (IS_ERR(ubi))
 607                 return PTR_ERR(ubi);
 608
 609         switch (cmd) {
 610         /* Create volume command */
 611         case UBI_IOCMKVOL:
 612         {
 613                 struct ubi_mkvol_req req;
 614
 615                 dbg_msg("create volume");
 616                 err = __copy_from_user(&req, argp,
 617                                        sizeof(struct ubi_mkvol_req));
 618                 if (err) {
 619                         err = -EFAULT;
 620                         break;
 621                 }
 622
 623                 err = verify_mkvol_req(ubi, &req);
 624                 if (err)
 625                         break;
 626
 627                 req.name[req.name_len] = '\0';
 628
 629                 err = ubi_create_volume(ubi, &req);
 630                 if (err)
 631                         break;
 632
 633                 err = __put_user(req.vol_id, (__user int32_t *)argp);
 634                 if (err)
 635                         err = -EFAULT;
 636
 637                 break;
 638         }
 639
 640         /* Remove volume command */
 641         case UBI_IOCRMVOL:
 642         {
 643                 int vol_id;
 644
 645                 dbg_msg("remove volume");
 646                 err = __get_user(vol_id, (__user int32_t *)argp);
 647                 if (err) {
 648                         err = -EFAULT;
 649                         break;
 650                 }
 651
 652                 desc = ubi_open_volume(ubi->ubi_num, vol_id, UBI_EXCLUSIVE);
 653                 if (IS_ERR(desc)) {
 654                         err = PTR_ERR(desc);
 655                         break;
 656                 }
 657
 658                 err = ubi_remove_volume(desc);
 659                 if (err)
 660                         ubi_close_volume(desc);
 661
 662                 break;
 663         }
 664
 665         /* Re-size volume command */
 666         case UBI_IOCRSVOL:
 667         {
 668                 int pebs;
 669                 uint64_t tmp;
 670                 struct ubi_rsvol_req req;
 671
 672                 dbg_msg("re-size volume");
 673                 err = __copy_from_user(&req, argp,
 674                                        sizeof(struct ubi_rsvol_req));
 675                 if (err) {
 676                         err = -EFAULT;
 677                         break;
 678                 }
 679
 680                 err = verify_rsvol_req(ubi, &req);
 681                 if (err)
 682                         break;
 683
 684                 desc = ubi_open_volume(ubi->ubi_num, req.vol_id, UBI_EXCLUSIVE);
 685                 if (IS_ERR(desc)) {
 686                         err = PTR_ERR(desc);
 687                         break;
 688                 }
 689
 690                 tmp = req.bytes;
 691                 pebs = !!do_div(tmp, desc->vol->usable_leb_size);
 692                 pebs += tmp;
 693
 694                 err = ubi_resize_volume(desc, pebs);
 695                 ubi_close_volume(desc);
 696                 break;
 697         }
 698
 699         default:
 700                 err = -ENOTTY;
 701                 break;
 702         }
 703
 704         return err;
 705 }
 706
 707 /* UBI character device operations */
 708 struct file_operations ubi_cdev_operations = {
 709         .owner = THIS_MODULE,
 710         .ioctl = ubi_cdev_ioctl,
 711         .llseek = no_llseek,
 712 };
 713
 714 /* UBI volume character device operations */
 715 struct file_operations ubi_vol_cdev_operations = {
 716         .owner   = THIS_MODULE,
 717         .open    = vol_cdev_open,
 718         .release = vol_cdev_release,
 719         .llseek  = vol_cdev_llseek,
 720         .read    = vol_cdev_read,
 721         .write   = vol_cdev_write,
 722         .ioctl   = vol_cdev_ioctl,
 723 };