| 1 | |
| 2 | |
| 3 | * Copyright (c) International Business Machines Corp., 2006
|
| 4 | *
|
| 5 | * Author: Artem Bityutskiy (Битюцкий Артём)
|
| 6 |
|
| 7 |
|
| 8 | |
| 9 | * This file includes implementation of UBI character device operations.
|
| 10 | *
|
| 11 | * There are two kinds of character devices in UBI: UBI character devices and
|
| 12 | * UBI volume character devices. UBI character devices allow users to
|
| 13 | * manipulate whole volumes: create, remove, and re-size them. Volume character
|
| 14 | * devices provide volume I/O capabilities.
|
| 15 | *
|
| 16 | * Major and minor numbers are assigned dynamically to both UBI and volume
|
| 17 | * character devices.
|
| 18 | *
|
| 19 | * Well, there is the third kind of character devices - the UBI control
|
| 20 | * character device, which allows to manipulate by UBI devices - create and
|
| 21 | * delete them. In other words, it is used for attaching and detaching MTD
|
| 22 | * devices.
|
| 23 |
|
| 24 |
|
| 25 | #include <linux/module.h>
|
| 26 | #include <linux/stat.h>
|
| 27 | #include <linux/slab.h>
|
| 28 | #include <linux/ioctl.h>
|
| 29 | #include <linux/capability.h>
|
| 30 | #include <linux/uaccess.h>
|
| 31 | #include <linux/compat.h>
|
| 32 | #include <linux/math64.h>
|
| 33 | #include <mtd/ubi-user.h>
|
| 34 | #include "ubi.h"
|
| 35 |
|
| 36 | |
| 37 | * get_exclusive - get exclusive access to an UBI volume.
|
| 38 | * @desc: volume descriptor
|
| 39 | *
|
| 40 | * This function changes UBI volume open mode to "exclusive". Returns previous
|
| 41 | * mode value (positive integer) in case of success and a negative error code
|
| 42 | * in case of failure.
|
| 43 |
|
| 44 | static int get_exclusive(struct ubi_volume_desc *desc)
|
| 45 | {
|
| 46 | int users, err;
|
| 47 | struct ubi_volume *vol = desc->vol;
|
| 48 |
|
| 49 | spin_lock(&vol->ubi->volumes_lock);
|
| 50 | users = vol->readers + vol->writers + vol->exclusive + vol->metaonly;
|
| 51 | ubi_assert(users > 0);
|
| 52 | if (users > 1) {
|
| 53 | ubi_err(vol->ubi, "%d users for volume %d", users, vol->vol_id);
|
| 54 | err = -EBUSY;
|
| 55 | } else {
|
| 56 | vol->readers = vol->writers = vol->metaonly = 0;
|
| 57 | vol->exclusive = 1;
|
| 58 | err = desc->mode;
|
| 59 | desc->mode = UBI_EXCLUSIVE;
|
| 60 | }
|
| 61 | spin_unlock(&vol->ubi->volumes_lock);
|
| 62 |
|
| 63 | return err;
|
| 64 | }
|
| 65 |
|
| 66 | |
| 67 | * revoke_exclusive - revoke exclusive mode.
|
| 68 | * @desc: volume descriptor
|
| 69 | * @mode: new mode to switch to
|
| 70 |
|
| 71 | static void revoke_exclusive(struct ubi_volume_desc *desc, int mode)
|
| 72 | {
|
| 73 | struct ubi_volume *vol = desc->vol;
|
| 74 |
|
| 75 | spin_lock(&vol->ubi->volumes_lock);
|
| 76 | ubi_assert(vol->readers == 0 && vol->writers == 0 && vol->metaonly == 0);
|
| 77 | ubi_assert(vol->exclusive == 1 && desc->mode == UBI_EXCLUSIVE);
|
| 78 | vol->exclusive = 0;
|
| 79 | if (mode == UBI_READONLY)
|
| 80 | vol->readers = 1;
|
| 81 | else if (mode == UBI_READWRITE)
|
| 82 | vol->writers = 1;
|
| 83 | else if (mode == UBI_METAONLY)
|
| 84 | vol->metaonly = 1;
|
| 85 | else
|
| 86 | vol->exclusive = 1;
|
| 87 | spin_unlock(&vol->ubi->volumes_lock);
|
| 88 |
|
| 89 | desc->mode = mode;
|
| 90 | }
|
| 91 |
|
| 92 | static int vol_cdev_open(struct inode *inode, struct file *file)
|
| 93 | {
|
| 94 | struct ubi_volume_desc *desc;
|
| 95 | int vol_id = iminor(inode) - 1, mode, ubi_num;
|
| 96 |
|
| 97 | ubi_num = ubi_major2num(imajor(inode));
|
| 98 | if (ubi_num < 0)
|
| 99 | return ubi_num;
|
| 100 |
|
| 101 | if (file->f_mode & FMODE_WRITE)
|
| 102 | mode = UBI_READWRITE;
|
| 103 | else
|
| 104 | mode = UBI_READONLY;
|
| 105 |
|
| 106 | dbg_gen("open device %d, volume %d, mode %d",
|
| 107 | ubi_num, vol_id, mode);
|
| 108 |
|
| 109 | desc = ubi_open_volume(ubi_num, vol_id, mode);
|
| 110 | if (IS_ERR(desc))
|
| 111 | return PTR_ERR(desc);
|
| 112 |
|
| 113 | file->private_data = desc;
|
| 114 | return 0;
|
| 115 | }
|
| 116 |
|
| 117 | static int vol_cdev_release(struct inode *inode, struct file *file)
|
| 118 | {
|
| 119 | struct ubi_volume_desc *desc = file->private_data;
|
| 120 | struct ubi_volume *vol = desc->vol;
|
| 121 |
|
| 122 | dbg_gen("release device %d, volume %d, mode %d",
|
| 123 | vol->ubi->ubi_num, vol->vol_id, desc->mode);
|
| 124 |
|
| 125 | if (vol->updating) {
|
| 126 | ubi_warn(vol->ubi, "update of volume %d not finished, volume is damaged",
|
| 127 | vol->vol_id);
|
| 128 | ubi_assert(!vol->changing_leb);
|
| 129 | vol->updating = 0;
|
| 130 | vfree(vol->upd_buf);
|
| 131 | } else if (vol->changing_leb) {
|
| 132 | dbg_gen("only %lld of %lld bytes received for atomic LEB change for volume %d:%d, cancel",
|
| 133 | vol->upd_received, vol->upd_bytes, vol->ubi->ubi_num,
|
| 134 | vol->vol_id);
|
| 135 | vol->changing_leb = 0;
|
| 136 | vfree(vol->upd_buf);
|
| 137 | }
|
| 138 |
|
| 139 | ubi_close_volume(desc);
|
| 140 | return 0;
|
| 141 | }
|
| 142 |
|
| 143 | static loff_t vol_cdev_llseek(struct file *file, loff_t offset, int origin)
|
| 144 | {
|
| 145 | struct ubi_volume_desc *desc = file->private_data;
|
| 146 | struct ubi_volume *vol = desc->vol;
|
| 147 |
|
| 148 | if (vol->updating) {
|
| 149 |
|
| 150 | ubi_err(vol->ubi, "updating");
|
| 151 | return -EBUSY;
|
| 152 | }
|
| 153 |
|
| 154 | return fixed_size_llseek(file, offset, origin, vol->used_bytes);
|
| 155 | }
|
| 156 |
|
| 157 | static int vol_cdev_fsync(struct file *file, loff_t start, loff_t end,
|
| 158 | int datasync)
|
| 159 | {
|
| 160 | struct ubi_volume_desc *desc = file->private_data;
|
| 161 | struct ubi_device *ubi = desc->vol->ubi;
|
| 162 | struct inode *inode = file_inode(file);
|
| 163 | int err;
|
| 164 | inode_lock(inode);
|
| 165 | err = ubi_sync(ubi->ubi_num);
|
| 166 | inode_unlock(inode);
|
| 167 | return err;
|
| 168 | }
|
| 169 |
|
| 170 |
|
| 171 | static ssize_t vol_cdev_read(struct file *file, __user char *buf, size_t count,
|
| 172 | loff_t *offp)
|
| 173 | {
|
| 174 | struct ubi_volume_desc *desc = file->private_data;
|
| 175 | struct ubi_volume *vol = desc->vol;
|
| 176 | struct ubi_device *ubi = vol->ubi;
|
| 177 | int err, lnum, off, len, tbuf_size;
|
| 178 | size_t count_save = count;
|
| 179 | void *tbuf;
|
| 180 |
|
| 181 | dbg_gen("read %zd bytes from offset %lld of volume %d",
|
| 182 | count, *offp, vol->vol_id);
|
| 183 |
|
| 184 | if (vol->updating) {
|
| 185 | ubi_err(vol->ubi, "updating");
|
| 186 | return -EBUSY;
|
| 187 | }
|
| 188 | if (vol->upd_marker) {
|
| 189 | ubi_err(vol->ubi, "damaged volume, update marker is set");
|
| 190 | return -EBADF;
|
| 191 | }
|
| 192 | if (*offp == vol->used_bytes || count == 0)
|
| 193 | return 0;
|
| 194 |
|
| 195 | if (vol->corrupted)
|
| 196 | dbg_gen("read from corrupted volume %d", vol->vol_id);
|
| 197 |
|
| 198 | if (*offp + count > vol->used_bytes)
|
| 199 | count_save = count = vol->used_bytes - *offp;
|
| 200 |
|
| 201 | tbuf_size = vol->usable_leb_size;
|
| 202 | if (count < tbuf_size)
|
| 203 | tbuf_size = ALIGN(count, ubi->min_io_size);
|
| 204 | tbuf = vmalloc(tbuf_size);
|
| 205 | if (!tbuf)
|
| 206 | return -ENOMEM;
|
| 207 |
|
| 208 | len = count > tbuf_size ? tbuf_size : count;
|
| 209 | lnum = div_u64_rem(*offp, vol->usable_leb_size, &off);
|
| 210 |
|
| 211 | do {
|
| 212 | cond_resched();
|
| 213 |
|
| 214 | if (off + len >= vol->usable_leb_size)
|
| 215 | len = vol->usable_leb_size - off;
|
| 216 |
|
| 217 | err = ubi_eba_read_leb(ubi, vol, lnum, tbuf, off, len, 0);
|
| 218 | if (err)
|
| 219 | break;
|
| 220 |
|
| 221 | off += len;
|
| 222 | if (off == vol->usable_leb_size) {
|
| 223 | lnum += 1;
|
| 224 | off -= vol->usable_leb_size;
|
| 225 | }
|
| 226 |
|
| 227 | count -= len;
|
| 228 | *offp += len;
|
| 229 |
|
| 230 | err = copy_to_user(buf, tbuf, len);
|
| 231 | if (err) {
|
| 232 | err = -EFAULT;
|
| 233 | break;
|
| 234 | }
|
| 235 |
|
| 236 | buf += len;
|
| 237 | len = count > tbuf_size ? tbuf_size : count;
|
| 238 | } while (count);
|
| 239 |
|
| 240 | vfree(tbuf);
|
| 241 | return err ? err : count_save - count;
|
| 242 | }
|
| 243 |
|
| 244 | |
| 245 | * This function allows to directly write to dynamic UBI volumes, without
|
| 246 | * issuing the volume update operation.
|
| 247 |
|
| 248 | static ssize_t vol_cdev_direct_write(struct file *file, const char __user *buf,
|
| 249 | size_t count, loff_t *offp)
|
| 250 | {
|
| 251 | struct ubi_volume_desc *desc = file->private_data;
|
| 252 | struct ubi_volume *vol = desc->vol;
|
| 253 | struct ubi_device *ubi = vol->ubi;
|
| 254 | int lnum, off, len, tbuf_size, err = 0;
|
| 255 | size_t count_save = count;
|
| 256 | char *tbuf;
|
| 257 |
|
| 258 | if (!vol->direct_writes)
|
| 259 | return -EPERM;
|
| 260 |
|
| 261 | dbg_gen("requested: write %zd bytes to offset %lld of volume %u",
|
| 262 | count, *offp, vol->vol_id);
|
| 263 |
|
| 264 | if (vol->vol_type == UBI_STATIC_VOLUME)
|
| 265 | return -EROFS;
|
| 266 |
|
| 267 | lnum = div_u64_rem(*offp, vol->usable_leb_size, &off);
|
| 268 | if (off & (ubi->min_io_size - 1)) {
|
| 269 | ubi_err(ubi, "unaligned position");
|
| 270 | return -EINVAL;
|
| 271 | }
|
| 272 |
|
| 273 | if (*offp + count > vol->used_bytes)
|
| 274 | count_save = count = vol->used_bytes - *offp;
|
| 275 |
|
| 276 |
|
| 277 | if (count & (ubi->min_io_size - 1)) {
|
| 278 | ubi_err(ubi, "unaligned write length");
|
| 279 | return -EINVAL;
|
| 280 | }
|
| 281 |
|
| 282 | tbuf_size = vol->usable_leb_size;
|
| 283 | if (count < tbuf_size)
|
| 284 | tbuf_size = ALIGN(count, ubi->min_io_size);
|
| 285 | tbuf = vmalloc(tbuf_size);
|
| 286 | if (!tbuf)
|
| 287 | return -ENOMEM;
|
| 288 |
|
| 289 | len = count > tbuf_size ? tbuf_size : count;
|
| 290 |
|
| 291 | while (count) {
|
| 292 | cond_resched();
|
| 293 |
|
| 294 | if (off + len >= vol->usable_leb_size)
|
| 295 | len = vol->usable_leb_size - off;
|
| 296 |
|
| 297 | err = copy_from_user(tbuf, buf, len);
|
| 298 | if (err) {
|
| 299 | err = -EFAULT;
|
| 300 | break;
|
| 301 | }
|
| 302 |
|
| 303 | err = ubi_eba_write_leb(ubi, vol, lnum, tbuf, off, len);
|
| 304 | if (err)
|
| 305 | break;
|
| 306 |
|
| 307 | off += len;
|
| 308 | if (off == vol->usable_leb_size) {
|
| 309 | lnum += 1;
|
| 310 | off -= vol->usable_leb_size;
|
| 311 | }
|
| 312 |
|
| 313 | count -= len;
|
| 314 | *offp += len;
|
| 315 | buf += len;
|
| 316 | len = count > tbuf_size ? tbuf_size : count;
|
| 317 | }
|
| 318 |
|
| 319 | vfree(tbuf);
|
| 320 | return err ? err : count_save - count;
|
| 321 | }
|
| 322 |
|
| 323 | static ssize_t vol_cdev_write(struct file *file, const char __user *buf,
|
| 324 | size_t count, loff_t *offp)
|
| 325 | {
|
| 326 | int err = 0;
|
| 327 | struct ubi_volume_desc *desc = file->private_data;
|
| 328 | struct ubi_volume *vol = desc->vol;
|
| 329 | struct ubi_device *ubi = vol->ubi;
|
| 330 |
|
| 331 | if (!vol->updating && !vol->changing_leb)
|
| 332 | return vol_cdev_direct_write(file, buf, count, offp);
|
| 333 |
|
| 334 | if (vol->updating)
|
| 335 | err = ubi_more_update_data(ubi, vol, buf, count);
|
| 336 | else
|
| 337 | err = ubi_more_leb_change_data(ubi, vol, buf, count);
|
| 338 |
|
| 339 | if (err < 0) {
|
| 340 | ubi_err(ubi, "cannot accept more %zd bytes of data, error %d",
|
| 341 | count, err);
|
| 342 | return err;
|
| 343 | }
|
| 344 |
|
| 345 | if (err) {
|
| 346 | |
| 347 | * The operation is finished, @err contains number of actually
|
| 348 | * written bytes.
|
| 349 |
|
| 350 | count = err;
|
| 351 |
|
| 352 | if (vol->changing_leb) {
|
| 353 | revoke_exclusive(desc, UBI_READWRITE);
|
| 354 | return count;
|
| 355 | }
|
| 356 |
|
| 357 | |
| 358 | * We voluntarily do not take into account the skip_check flag
|
| 359 | * as we want to make sure what we wrote was correctly written.
|
| 360 |
|
| 361 | err = ubi_check_volume(ubi, vol->vol_id);
|
| 362 | if (err < 0)
|
| 363 | return err;
|
| 364 |
|
| 365 | if (err) {
|
| 366 | ubi_warn(ubi, "volume %d on UBI device %d is corrupted",
|
| 367 | vol->vol_id, ubi->ubi_num);
|
| 368 | vol->corrupted = 1;
|
| 369 | }
|
| 370 | vol->checked = 1;
|
| 371 | ubi_volume_notify(ubi, vol, UBI_VOLUME_UPDATED);
|
| 372 | revoke_exclusive(desc, UBI_READWRITE);
|
| 373 | }
|
| 374 |
|
| 375 | return count;
|
| 376 | }
|
| 377 |
|
| 378 | static long vol_cdev_ioctl(struct file *file, unsigned int cmd,
|
| 379 | unsigned long arg)
|
| 380 | {
|
| 381 | int err = 0;
|
| 382 | struct ubi_volume_desc *desc = file->private_data;
|
| 383 | struct ubi_volume *vol = desc->vol;
|
| 384 | struct ubi_device *ubi = vol->ubi;
|
| 385 | void __user *argp = (void __user *)arg;
|
| 386 |
|
| 387 | switch (cmd) {
|
| 388 |
|
| 389 | case UBI_IOCVOLUP:
|
| 390 | {
|
| 391 | int64_t bytes, rsvd_bytes;
|
| 392 |
|
| 393 | if (!capable(CAP_SYS_RESOURCE)) {
|
| 394 | err = -EPERM;
|
| 395 | break;
|
| 396 | }
|
| 397 |
|
| 398 | err = copy_from_user(&bytes, argp, sizeof(int64_t));
|
| 399 | if (err) {
|
| 400 | err = -EFAULT;
|
| 401 | break;
|
| 402 | }
|
| 403 |
|
| 404 | if (desc->mode == UBI_READONLY) {
|
| 405 | err = -EROFS;
|
| 406 | break;
|
| 407 | }
|
| 408 |
|
| 409 | rsvd_bytes = (long long)vol->reserved_pebs *
|
| 410 | vol->usable_leb_size;
|
| 411 | if (bytes < 0 || bytes > rsvd_bytes) {
|
| 412 | err = -EINVAL;
|
| 413 | break;
|
| 414 | }
|
| 415 |
|
| 416 | err = get_exclusive(desc);
|
| 417 | if (err < 0)
|
| 418 | break;
|
| 419 |
|
| 420 | err = ubi_start_update(ubi, vol, bytes);
|
| 421 | if (bytes == 0) {
|
| 422 | ubi_volume_notify(ubi, vol, UBI_VOLUME_UPDATED);
|
| 423 | revoke_exclusive(desc, UBI_READWRITE);
|
| 424 | }
|
| 425 | break;
|
| 426 | }
|
| 427 |
|
| 428 |
|
| 429 | case UBI_IOCEBCH:
|
| 430 | {
|
| 431 | struct ubi_leb_change_req req;
|
| 432 |
|
| 433 | err = copy_from_user(&req, argp,
|
| 434 | sizeof(struct ubi_leb_change_req));
|
| 435 | if (err) {
|
| 436 | err = -EFAULT;
|
| 437 | break;
|
| 438 | }
|
| 439 |
|
| 440 | if (desc->mode == UBI_READONLY ||
|
| 441 | vol->vol_type == UBI_STATIC_VOLUME) {
|
| 442 | err = -EROFS;
|
| 443 | break;
|
| 444 | }
|
| 445 |
|
| 446 |
|
| 447 | err = -EINVAL;
|
| 448 | if (!ubi_leb_valid(vol, req.lnum) ||
|
| 449 | req.bytes < 0 || req.bytes > vol->usable_leb_size)
|
| 450 | break;
|
| 451 |
|
| 452 | err = get_exclusive(desc);
|
| 453 | if (err < 0)
|
| 454 | break;
|
| 455 |
|
| 456 | err = ubi_start_leb_change(ubi, vol, &req);
|
| 457 | if (req.bytes == 0)
|
| 458 | revoke_exclusive(desc, UBI_READWRITE);
|
| 459 | break;
|
| 460 | }
|
| 461 |
|
| 462 |
|
| 463 | case UBI_IOCEBER:
|
| 464 | {
|
| 465 | int32_t lnum;
|
| 466 |
|
| 467 | err = get_user(lnum, (__user int32_t *)argp);
|
| 468 | if (err) {
|
| 469 | err = -EFAULT;
|
| 470 | break;
|
| 471 | }
|
| 472 |
|
| 473 | if (desc->mode == UBI_READONLY ||
|
| 474 | vol->vol_type == UBI_STATIC_VOLUME) {
|
| 475 | err = -EROFS;
|
| 476 | break;
|
| 477 | }
|
| 478 |
|
| 479 | if (!ubi_leb_valid(vol, lnum)) {
|
| 480 | err = -EINVAL;
|
| 481 | break;
|
| 482 | }
|
| 483 |
|
| 484 | dbg_gen("erase LEB %d:%d", vol->vol_id, lnum);
|
| 485 | err = ubi_eba_unmap_leb(ubi, vol, lnum);
|
| 486 | if (err)
|
| 487 | break;
|
| 488 |
|
| 489 | err = ubi_wl_flush(ubi, UBI_ALL, UBI_ALL);
|
| 490 | break;
|
| 491 | }
|
| 492 |
|
| 493 |
|
| 494 | case UBI_IOCEBMAP:
|
| 495 | {
|
| 496 | struct ubi_map_req req;
|
| 497 |
|
| 498 | err = copy_from_user(&req, argp, sizeof(struct ubi_map_req));
|
| 499 | if (err) {
|
| 500 | err = -EFAULT;
|
| 501 | break;
|
| 502 | }
|
| 503 | err = ubi_leb_map(desc, req.lnum);
|
| 504 | break;
|
| 505 | }
|
| 506 |
|
| 507 |
|
| 508 | case UBI_IOCEBUNMAP:
|
| 509 | {
|
| 510 | int32_t lnum;
|
| 511 |
|
| 512 | err = get_user(lnum, (__user int32_t *)argp);
|
| 513 | if (err) {
|
| 514 | err = -EFAULT;
|
| 515 | break;
|
| 516 | }
|
| 517 | err = ubi_leb_unmap(desc, lnum);
|
| 518 | break;
|
| 519 | }
|
| 520 |
|
| 521 |
|
| 522 | case UBI_IOCEBISMAP:
|
| 523 | {
|
| 524 | int32_t lnum;
|
| 525 |
|
| 526 | err = get_user(lnum, (__user int32_t *)argp);
|
| 527 | if (err) {
|
| 528 | err = -EFAULT;
|
| 529 | break;
|
| 530 | }
|
| 531 | err = ubi_is_mapped(desc, lnum);
|
| 532 | break;
|
| 533 | }
|
| 534 |
|
| 535 |
|
| 536 | case UBI_IOCSETVOLPROP:
|
| 537 | {
|
| 538 | struct ubi_set_vol_prop_req req;
|
| 539 |
|
| 540 | err = copy_from_user(&req, argp,
|
| 541 | sizeof(struct ubi_set_vol_prop_req));
|
| 542 | if (err) {
|
| 543 | err = -EFAULT;
|
| 544 | break;
|
| 545 | }
|
| 546 | switch (req.property) {
|
| 547 | case UBI_VOL_PROP_DIRECT_WRITE:
|
| 548 | mutex_lock(&ubi->device_mutex);
|
| 549 | desc->vol->direct_writes = !!req.value;
|
| 550 | mutex_unlock(&ubi->device_mutex);
|
| 551 | break;
|
| 552 | default:
|
| 553 | err = -EINVAL;
|
| 554 | break;
|
| 555 | }
|
| 556 | break;
|
| 557 | }
|
| 558 |
|
| 559 |
|
| 560 | case UBI_IOCVOLCRBLK:
|
| 561 | {
|
| 562 | struct ubi_volume_info vi;
|
| 563 |
|
| 564 | ubi_get_volume_info(desc, &vi);
|
| 565 | err = ubiblock_create(&vi);
|
| 566 | break;
|
| 567 | }
|
| 568 |
|
| 569 |
|
| 570 | case UBI_IOCVOLRMBLK:
|
| 571 | {
|
| 572 | struct ubi_volume_info vi;
|
| 573 |
|
| 574 | ubi_get_volume_info(desc, &vi);
|
| 575 | err = ubiblock_remove(&vi);
|
| 576 | break;
|
| 577 | }
|
| 578 |
|
| 579 | default:
|
| 580 | err = -ENOTTY;
|
| 581 | break;
|
| 582 | }
|
| 583 | return err;
|
| 584 | }
|
| 585 |
|
| 586 | |
| 587 | * verify_mkvol_req - verify volume creation request.
|
| 588 | * @ubi: UBI device description object
|
| 589 | * @req: the request to check
|
| 590 | *
|
| 591 | * This function zero if the request is correct, and %-EINVAL if not.
|
| 592 |
|
| 593 | static int verify_mkvol_req(const struct ubi_device *ubi,
|
| 594 | const struct ubi_mkvol_req *req)
|
| 595 | {
|
| 596 | int n, err = -EINVAL;
|
| 597 |
|
| 598 | if (req->bytes < 0 || req->alignment < 0 || req->vol_type < 0 ||
|
| 599 | req->name_len < 0)
|
| 600 | goto bad;
|
| 601 |
|
| 602 | if ((req->vol_id < 0 || req->vol_id >= ubi->vtbl_slots) &&
|
| 603 | req->vol_id != UBI_VOL_NUM_AUTO)
|
| 604 | goto bad;
|
| 605 |
|
| 606 | if (req->alignment == 0)
|
| 607 | goto bad;
|
| 608 |
|
| 609 | if (req->bytes == 0)
|
| 610 | goto bad;
|
| 611 |
|
| 612 | if (req->vol_type != UBI_DYNAMIC_VOLUME &&
|
| 613 | req->vol_type != UBI_STATIC_VOLUME)
|
| 614 | goto bad;
|
| 615 |
|
| 616 | if (req->flags & ~UBI_VOL_VALID_FLGS)
|
| 617 | goto bad;
|
| 618 |
|
| 619 | if (req->flags & UBI_VOL_SKIP_CRC_CHECK_FLG &&
|
| 620 | req->vol_type != UBI_STATIC_VOLUME)
|
| 621 | goto bad;
|
| 622 |
|
| 623 | if (req->alignment > ubi->leb_size)
|
| 624 | goto bad;
|
| 625 |
|
| 626 | n = req->alignment & (ubi->min_io_size - 1);
|
| 627 | if (req->alignment != 1 && n)
|
| 628 | goto bad;
|
| 629 |
|
| 630 | if (!req->name[0] || !req->name_len)
|
| 631 | goto bad;
|
| 632 |
|
| 633 | if (req->name_len > UBI_VOL_NAME_MAX) {
|
| 634 | err = -ENAMETOOLONG;
|
| 635 | goto bad;
|
| 636 | }
|
| 637 |
|
| 638 | n = strnlen(req->name, req->name_len + 1);
|
| 639 | if (n != req->name_len)
|
| 640 | goto bad;
|
| 641 |
|
| 642 | return 0;
|
| 643 |
|
| 644 | bad:
|
| 645 | ubi_err(ubi, "bad volume creation request");
|
| 646 | ubi_dump_mkvol_req(req);
|
| 647 | return err;
|
| 648 | }
|
| 649 |
|
| 650 | |
| 651 | * verify_rsvol_req - verify volume re-size request.
|
| 652 | * @ubi: UBI device description object
|
| 653 | * @req: the request to check
|
| 654 | *
|
| 655 | * This function returns zero if the request is correct, and %-EINVAL if not.
|
| 656 |
|
| 657 | static int verify_rsvol_req(const struct ubi_device *ubi,
|
| 658 | const struct ubi_rsvol_req *req)
|
| 659 | {
|
| 660 | if (req->bytes <= 0)
|
| 661 | return -EINVAL;
|
| 662 |
|
| 663 | if (req->vol_id < 0 || req->vol_id >= ubi->vtbl_slots)
|
| 664 | return -EINVAL;
|
| 665 |
|
| 666 | return 0;
|
| 667 | }
|
| 668 |
|
| 669 | |
| 670 | * rename_volumes - rename UBI volumes.
|
| 671 | * @ubi: UBI device description object
|
| 672 | * @req: volumes re-name request
|
| 673 | *
|
| 674 | * This is a helper function for the volume re-name IOCTL which validates the
|
| 675 | * request, opens the volume and calls corresponding volumes management
|
| 676 | * function. Returns zero in case of success and a negative error code in case
|
| 677 | * of failure.
|
| 678 |
|
| 679 | static int rename_volumes(struct ubi_device *ubi,
|
| 680 | struct ubi_rnvol_req *req)
|
| 681 | {
|
| 682 | int i, n, err;
|
| 683 | struct list_head rename_list;
|
| 684 | struct ubi_rename_entry *re, *re1;
|
| 685 |
|
| 686 | if (req->count < 0 || req->count > UBI_MAX_RNVOL)
|
| 687 | return -EINVAL;
|
| 688 |
|
| 689 | if (req->count == 0)
|
| 690 | return 0;
|
| 691 |
|
| 692 |
|
| 693 | for (i = 0; i < req->count; i++) {
|
| 694 | if (req->ents[i].vol_id < 0 ||
|
| 695 | req->ents[i].vol_id >= ubi->vtbl_slots)
|
| 696 | return -EINVAL;
|
| 697 | if (req->ents[i].name_len < 0)
|
| 698 | return -EINVAL;
|
| 699 | if (req->ents[i].name_len > UBI_VOL_NAME_MAX)
|
| 700 | return -ENAMETOOLONG;
|
| 701 | req->ents[i].name[req->ents[i].name_len] = '\0';
|
| 702 | n = strlen(req->ents[i].name);
|
| 703 | if (n != req->ents[i].name_len)
|
| 704 | return -EINVAL;
|
| 705 | }
|
| 706 |
|
| 707 |
|
| 708 | for (i = 0; i < req->count - 1; i++) {
|
| 709 | for (n = i + 1; n < req->count; n++) {
|
| 710 | if (req->ents[i].vol_id == req->ents[n].vol_id) {
|
| 711 | ubi_err(ubi, "duplicated volume id %d",
|
| 712 | req->ents[i].vol_id);
|
| 713 | return -EINVAL;
|
| 714 | }
|
| 715 | if (!strcmp(req->ents[i].name, req->ents[n].name)) {
|
| 716 | ubi_err(ubi, "duplicated volume name \"%s\"",
|
| 717 | req->ents[i].name);
|
| 718 | return -EINVAL;
|
| 719 | }
|
| 720 | }
|
| 721 | }
|
| 722 |
|
| 723 |
|
| 724 | INIT_LIST_HEAD(&rename_list);
|
| 725 | for (i = 0; i < req->count; i++) {
|
| 726 | int vol_id = req->ents[i].vol_id;
|
| 727 | int name_len = req->ents[i].name_len;
|
| 728 | const char *name = req->ents[i].name;
|
| 729 |
|
| 730 | re = kzalloc_obj(struct ubi_rename_entry);
|
| 731 | if (!re) {
|
| 732 | err = -ENOMEM;
|
| 733 | goto out_free;
|
| 734 | }
|
| 735 |
|
| 736 | re->desc = ubi_open_volume(ubi->ubi_num, vol_id, UBI_METAONLY);
|
| 737 | if (IS_ERR(re->desc)) {
|
| 738 | err = PTR_ERR(re->desc);
|
| 739 | ubi_err(ubi, "cannot open volume %d, error %d",
|
| 740 | vol_id, err);
|
| 741 | kfree(re);
|
| 742 | goto out_free;
|
| 743 | }
|
| 744 |
|
| 745 |
|
| 746 | if (re->desc->vol->name_len == name_len &&
|
| 747 | !memcmp(re->desc->vol->name, name, name_len)) {
|
| 748 | ubi_close_volume(re->desc);
|
| 749 | kfree(re);
|
| 750 | continue;
|
| 751 | }
|
| 752 |
|
| 753 | re->new_name_len = name_len;
|
| 754 | memcpy(re->new_name, name, name_len);
|
| 755 | list_add_tail(&re->list, &rename_list);
|
| 756 | dbg_gen("will rename volume %d from \"%s\" to \"%s\"",
|
| 757 | vol_id, re->desc->vol->name, name);
|
| 758 | }
|
| 759 |
|
| 760 | if (list_empty(&rename_list))
|
| 761 | return 0;
|
| 762 |
|
| 763 |
|
| 764 | list_for_each_entry(re, &rename_list, list) {
|
| 765 | struct ubi_volume_desc *desc;
|
| 766 | int no_remove_needed = 0;
|
| 767 |
|
| 768 | |
| 769 | * Volume @re->vol_id is going to be re-named to
|
| 770 | * @re->new_name, while its current name is @name. If a volume
|
| 771 | * with name @re->new_name currently exists, it has to be
|
| 772 | * removed, unless it is also re-named in the request (@req).
|
| 773 |
|
| 774 | list_for_each_entry(re1, &rename_list, list) {
|
| 775 | if (re->new_name_len == re1->desc->vol->name_len &&
|
| 776 | !memcmp(re->new_name, re1->desc->vol->name,
|
| 777 | re1->desc->vol->name_len)) {
|
| 778 | no_remove_needed = 1;
|
| 779 | break;
|
| 780 | }
|
| 781 | }
|
| 782 |
|
| 783 | if (no_remove_needed)
|
| 784 | continue;
|
| 785 |
|
| 786 | |
| 787 | * It seems we need to remove volume with name @re->new_name,
|
| 788 | * if it exists.
|
| 789 |
|
| 790 | desc = ubi_open_volume_nm(ubi->ubi_num, re->new_name,
|
| 791 | UBI_EXCLUSIVE);
|
| 792 | if (IS_ERR(desc)) {
|
| 793 | err = PTR_ERR(desc);
|
| 794 | if (err == -ENODEV)
|
| 795 |
|
| 796 | continue;
|
| 797 |
|
| 798 |
|
| 799 | ubi_err(ubi, "cannot open volume \"%s\", error %d",
|
| 800 | re->new_name, err);
|
| 801 | goto out_free;
|
| 802 | }
|
| 803 |
|
| 804 | re1 = kzalloc_obj(struct ubi_rename_entry);
|
| 805 | if (!re1) {
|
| 806 | err = -ENOMEM;
|
| 807 | ubi_close_volume(desc);
|
| 808 | goto out_free;
|
| 809 | }
|
| 810 |
|
| 811 | re1->remove = 1;
|
| 812 | re1->desc = desc;
|
| 813 | list_add(&re1->list, &rename_list);
|
| 814 | dbg_gen("will remove volume %d, name \"%s\"",
|
| 815 | re1->desc->vol->vol_id, re1->desc->vol->name);
|
| 816 | }
|
| 817 |
|
| 818 | mutex_lock(&ubi->device_mutex);
|
| 819 | err = ubi_rename_volumes(ubi, &rename_list);
|
| 820 | mutex_unlock(&ubi->device_mutex);
|
| 821 |
|
| 822 | out_free:
|
| 823 | list_for_each_entry_safe(re, re1, &rename_list, list) {
|
| 824 | ubi_close_volume(re->desc);
|
| 825 | list_del(&re->list);
|
| 826 | kfree(re);
|
| 827 | }
|
| 828 | return err;
|
| 829 | }
|
| 830 |
|
| 831 | static int ubi_get_ec_info(struct ubi_device *ubi, struct ubi_ecinfo_req __user *ureq)
|
| 832 | {
|
| 833 | struct ubi_ecinfo_req req;
|
| 834 | struct ubi_wl_entry *wl;
|
| 835 | int read_cnt;
|
| 836 | int peb;
|
| 837 | int end_peb;
|
| 838 |
|
| 839 |
|
| 840 | if (copy_from_user(&req, ureq, sizeof(struct ubi_ecinfo_req)))
|
| 841 | return -EFAULT;
|
| 842 |
|
| 843 |
|
| 844 | if (req.length <= 0 || req.start < 0 || req.start >= ubi->peb_count)
|
| 845 | return -EINVAL;
|
| 846 |
|
| 847 | if (check_add_overflow(req.start, req.length, &end_peb))
|
| 848 | return -EINVAL;
|
| 849 |
|
| 850 | if (end_peb > ubi->peb_count)
|
| 851 | end_peb = ubi->peb_count;
|
| 852 |
|
| 853 |
|
| 854 | if (!access_ok((void __user *)ureq->erase_counters,
|
| 855 | (end_peb-req.start) * sizeof(int32_t)))
|
| 856 | return -EFAULT;
|
| 857 |
|
| 858 |
|
| 859 | read_cnt = 0;
|
| 860 | for (peb = req.start; peb < end_peb; read_cnt++, peb++) {
|
| 861 | int ec;
|
| 862 |
|
| 863 | if (ubi_io_is_bad(ubi, peb)) {
|
| 864 | if (__put_user(UBI_UNKNOWN, ureq->erase_counters+read_cnt))
|
| 865 | return -EFAULT;
|
| 866 |
|
| 867 | continue;
|
| 868 | }
|
| 869 |
|
| 870 | spin_lock(&ubi->wl_lock);
|
| 871 |
|
| 872 | wl = ubi->lookuptbl[peb];
|
| 873 | if (wl)
|
| 874 | ec = wl->ec;
|
| 875 | else
|
| 876 | ec = UBI_UNKNOWN;
|
| 877 |
|
| 878 | spin_unlock(&ubi->wl_lock);
|
| 879 |
|
| 880 | if (__put_user(ec, ureq->erase_counters+read_cnt))
|
| 881 | return -EFAULT;
|
| 882 |
|
| 883 | }
|
| 884 |
|
| 885 |
|
| 886 | req.read_length = read_cnt;
|
| 887 |
|
| 888 |
|
| 889 | if (copy_to_user(ureq, &req, sizeof(struct ubi_ecinfo_req)))
|
| 890 | return -EFAULT;
|
| 891 |
|
| 892 | return 0;
|
| 893 | }
|
| 894 |
|
| 895 | static long ubi_cdev_ioctl(struct file *file, unsigned int cmd,
|
| 896 | unsigned long arg)
|
| 897 | {
|
| 898 | int err = 0;
|
| 899 | struct ubi_device *ubi;
|
| 900 | struct ubi_volume_desc *desc;
|
| 901 | void __user *argp = (void __user *)arg;
|
| 902 |
|
| 903 | if (!capable(CAP_SYS_RESOURCE))
|
| 904 | return -EPERM;
|
| 905 |
|
| 906 | ubi = ubi_get_by_major(imajor(file->f_mapping->host));
|
| 907 | if (!ubi)
|
| 908 | return -ENODEV;
|
| 909 |
|
| 910 | switch (cmd) {
|
| 911 |
|
| 912 | case UBI_IOCMKVOL:
|
| 913 | {
|
| 914 | struct ubi_mkvol_req req;
|
| 915 |
|
| 916 | dbg_gen("create volume");
|
| 917 | err = copy_from_user(&req, argp, sizeof(struct ubi_mkvol_req));
|
| 918 | if (err) {
|
| 919 | err = -EFAULT;
|
| 920 | break;
|
| 921 | }
|
| 922 |
|
| 923 | err = verify_mkvol_req(ubi, &req);
|
| 924 | if (err)
|
| 925 | break;
|
| 926 |
|
| 927 | mutex_lock(&ubi->device_mutex);
|
| 928 | err = ubi_create_volume(ubi, &req);
|
| 929 | mutex_unlock(&ubi->device_mutex);
|
| 930 | if (err)
|
| 931 | break;
|
| 932 |
|
| 933 | err = put_user(req.vol_id, (__user int32_t *)argp);
|
| 934 | if (err)
|
| 935 | err = -EFAULT;
|
| 936 |
|
| 937 | break;
|
| 938 | }
|
| 939 |
|
| 940 |
|
| 941 | case UBI_IOCRMVOL:
|
| 942 | {
|
| 943 | int vol_id;
|
| 944 |
|
| 945 | dbg_gen("remove volume");
|
| 946 | err = get_user(vol_id, (__user int32_t *)argp);
|
| 947 | if (err) {
|
| 948 | err = -EFAULT;
|
| 949 | break;
|
| 950 | }
|
| 951 |
|
| 952 | desc = ubi_open_volume(ubi->ubi_num, vol_id, UBI_EXCLUSIVE);
|
| 953 | if (IS_ERR(desc)) {
|
| 954 | err = PTR_ERR(desc);
|
| 955 | break;
|
| 956 | }
|
| 957 |
|
| 958 | mutex_lock(&ubi->device_mutex);
|
| 959 | err = ubi_remove_volume(desc, 0);
|
| 960 | mutex_unlock(&ubi->device_mutex);
|
| 961 |
|
| 962 | |
| 963 | * The volume is deleted (unless an error occurred), and the
|
| 964 | * 'struct ubi_volume' object will be freed when
|
| 965 | * 'ubi_close_volume()' will call 'put_device()'.
|
| 966 |
|
| 967 | ubi_close_volume(desc);
|
| 968 | break;
|
| 969 | }
|
| 970 |
|
| 971 |
|
| 972 | case UBI_IOCRSVOL:
|
| 973 | {
|
| 974 | int pebs;
|
| 975 | struct ubi_rsvol_req req;
|
| 976 |
|
| 977 | dbg_gen("re-size volume");
|
| 978 | err = copy_from_user(&req, argp, sizeof(struct ubi_rsvol_req));
|
| 979 | if (err) {
|
| 980 | err = -EFAULT;
|
| 981 | break;
|
| 982 | }
|
| 983 |
|
| 984 | err = verify_rsvol_req(ubi, &req);
|
| 985 | if (err)
|
| 986 | break;
|
| 987 |
|
| 988 | desc = ubi_open_volume(ubi->ubi_num, req.vol_id, UBI_EXCLUSIVE);
|
| 989 | if (IS_ERR(desc)) {
|
| 990 | err = PTR_ERR(desc);
|
| 991 | break;
|
| 992 | }
|
| 993 |
|
| 994 | pebs = div_u64(req.bytes + desc->vol->usable_leb_size - 1,
|
| 995 | desc->vol->usable_leb_size);
|
| 996 |
|
| 997 | mutex_lock(&ubi->device_mutex);
|
| 998 | err = ubi_resize_volume(desc, pebs);
|
| 999 | mutex_unlock(&ubi->device_mutex);
|
| 1000 | ubi_close_volume(desc);
|
| 1001 | break;
|
| 1002 | }
|
| 1003 |
|
| 1004 |
|
| 1005 | case UBI_IOCRNVOL:
|
| 1006 | {
|
| 1007 | struct ubi_rnvol_req *req;
|
| 1008 |
|
| 1009 | dbg_gen("re-name volumes");
|
| 1010 | req = kmalloc_obj(struct ubi_rnvol_req);
|
| 1011 | if (!req) {
|
| 1012 | err = -ENOMEM;
|
| 1013 | break;
|
| 1014 | }
|
| 1015 |
|
| 1016 | err = copy_from_user(req, argp, sizeof(struct ubi_rnvol_req));
|
| 1017 | if (err) {
|
| 1018 | err = -EFAULT;
|
| 1019 | kfree(req);
|
| 1020 | break;
|
| 1021 | }
|
| 1022 |
|
| 1023 | err = rename_volumes(ubi, req);
|
| 1024 | kfree(req);
|
| 1025 | break;
|
| 1026 | }
|
| 1027 |
|
| 1028 |
|
| 1029 | case UBI_IOCRPEB:
|
| 1030 | {
|
| 1031 | int pnum;
|
| 1032 |
|
| 1033 | err = get_user(pnum, (__user int32_t *)argp);
|
| 1034 | if (err) {
|
| 1035 | err = -EFAULT;
|
| 1036 | break;
|
| 1037 | }
|
| 1038 |
|
| 1039 | err = ubi_bitflip_check(ubi, pnum, 0);
|
| 1040 | break;
|
| 1041 | }
|
| 1042 |
|
| 1043 |
|
| 1044 | case UBI_IOCSPEB:
|
| 1045 | {
|
| 1046 | int pnum;
|
| 1047 |
|
| 1048 | err = get_user(pnum, (__user int32_t *)argp);
|
| 1049 | if (err) {
|
| 1050 | err = -EFAULT;
|
| 1051 | break;
|
| 1052 | }
|
| 1053 |
|
| 1054 | err = ubi_bitflip_check(ubi, pnum, 1);
|
| 1055 | break;
|
| 1056 | }
|
| 1057 |
|
| 1058 | case UBI_IOCECNFO:
|
| 1059 | {
|
| 1060 | err = ubi_get_ec_info(ubi, argp);
|
| 1061 | break;
|
| 1062 | }
|
| 1063 |
|
| 1064 | default:
|
| 1065 | err = -ENOTTY;
|
| 1066 | break;
|
| 1067 | }
|
| 1068 |
|
| 1069 | ubi_put_device(ubi);
|
| 1070 | return err;
|
| 1071 | }
|
| 1072 |
|
| 1073 | static long ctrl_cdev_ioctl(struct file *file, unsigned int cmd,
|
| 1074 | unsigned long arg)
|
| 1075 | {
|
| 1076 | int err = 0;
|
| 1077 | void __user *argp = (void __user *)arg;
|
| 1078 |
|
| 1079 | if (!capable(CAP_SYS_RESOURCE))
|
| 1080 | return -EPERM;
|
| 1081 |
|
| 1082 | switch (cmd) {
|
| 1083 |
|
| 1084 | case UBI_IOCATT:
|
| 1085 | {
|
| 1086 | struct ubi_attach_req req;
|
| 1087 | struct mtd_info *mtd;
|
| 1088 |
|
| 1089 | dbg_gen("attach MTD device");
|
| 1090 | err = copy_from_user(&req, argp, sizeof(struct ubi_attach_req));
|
| 1091 | if (err) {
|
| 1092 | err = -EFAULT;
|
| 1093 | break;
|
| 1094 | }
|
| 1095 |
|
| 1096 | if (req.mtd_num < 0 ||
|
| 1097 | (req.ubi_num < 0 && req.ubi_num != UBI_DEV_NUM_AUTO)) {
|
| 1098 | err = -EINVAL;
|
| 1099 | break;
|
| 1100 | }
|
| 1101 |
|
| 1102 | mtd = get_mtd_device(NULL, req.mtd_num);
|
| 1103 | if (IS_ERR(mtd)) {
|
| 1104 | err = PTR_ERR(mtd);
|
| 1105 | break;
|
| 1106 | }
|
| 1107 |
|
| 1108 | |
| 1109 | * Note, further request verification is done by
|
| 1110 | * 'ubi_attach_mtd_dev()'.
|
| 1111 |
|
| 1112 | mutex_lock(&ubi_devices_mutex);
|
| 1113 | err = ubi_attach_mtd_dev(mtd, req.ubi_num, req.vid_hdr_offset,
|
| 1114 | req.max_beb_per1024, !!req.disable_fm,
|
| 1115 | !!req.need_resv_pool, req.wl_threshold);
|
| 1116 | mutex_unlock(&ubi_devices_mutex);
|
| 1117 | if (err < 0)
|
| 1118 | put_mtd_device(mtd);
|
| 1119 | else
|
| 1120 |
|
| 1121 | err = put_user(err, (__user int32_t *)argp);
|
| 1122 |
|
| 1123 | break;
|
| 1124 | }
|
| 1125 |
|
| 1126 |
|
| 1127 | case UBI_IOCDET:
|
| 1128 | {
|
| 1129 | int ubi_num;
|
| 1130 |
|
| 1131 | dbg_gen("detach MTD device");
|
| 1132 | err = get_user(ubi_num, (__user int32_t *)argp);
|
| 1133 | if (err) {
|
| 1134 | err = -EFAULT;
|
| 1135 | break;
|
| 1136 | }
|
| 1137 |
|
| 1138 | mutex_lock(&ubi_devices_mutex);
|
| 1139 | err = ubi_detach_mtd_dev(ubi_num, 0);
|
| 1140 | mutex_unlock(&ubi_devices_mutex);
|
| 1141 | break;
|
| 1142 | }
|
| 1143 |
|
| 1144 | default:
|
| 1145 | err = -ENOTTY;
|
| 1146 | break;
|
| 1147 | }
|
| 1148 |
|
| 1149 | return err;
|
| 1150 | }
|
| 1151 |
|
| 1152 |
|
| 1153 | const struct file_operations ubi_vol_cdev_operations = {
|
| 1154 | .owner = THIS_MODULE,
|
| 1155 | .open = vol_cdev_open,
|
| 1156 | .release = vol_cdev_release,
|
| 1157 | .llseek = vol_cdev_llseek,
|
| 1158 | .read = vol_cdev_read,
|
| 1159 | .write = vol_cdev_write,
|
| 1160 | .fsync = vol_cdev_fsync,
|
| 1161 | .unlocked_ioctl = vol_cdev_ioctl,
|
| 1162 | .compat_ioctl = compat_ptr_ioctl,
|
| 1163 | };
|
| 1164 |
|
| 1165 |
|
| 1166 | const struct file_operations ubi_cdev_operations = {
|
| 1167 | .owner = THIS_MODULE,
|
| 1168 | .unlocked_ioctl = ubi_cdev_ioctl,
|
| 1169 | .compat_ioctl = compat_ptr_ioctl,
|
| 1170 | };
|
| 1171 |
|
| 1172 |
|
| 1173 | const struct file_operations ubi_ctrl_cdev_operations = {
|
| 1174 | .owner = THIS_MODULE,
|
| 1175 | .unlocked_ioctl = ctrl_cdev_ioctl,
|
| 1176 | .compat_ioctl = compat_ptr_ioctl,
|
| 1177 | };
|