linux/drivers/s390/char/tape_char.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 *    character device frontend for tape device driver
   4 *
   5 *  S390 and zSeries version
   6 *    Copyright IBM Corp. 2001, 2006
   7 *    Author(s): Carsten Otte <cotte@de.ibm.com>
   8 *               Michael Holzheu <holzheu@de.ibm.com>
   9 *               Tuan Ngo-Anh <ngoanh@de.ibm.com>
  10 *               Martin Schwidefsky <schwidefsky@de.ibm.com>
  11 */
  12
  13#define KMSG_COMPONENT "tape"
  14#define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
  15
  16#include <linux/module.h>
  17#include <linux/types.h>
  18#include <linux/proc_fs.h>
  19#include <linux/mtio.h>
  20#include <linux/compat.h>
  21
  22#include <linux/uaccess.h>
  23
  24#define TAPE_DBF_AREA   tape_core_dbf
  25
  26#include "tape.h"
  27#include "tape_std.h"
  28#include "tape_class.h"
  29
  30#define TAPECHAR_MAJOR          0       /* get dynamic major */
  31
  32/*
  33 * file operation structure for tape character frontend
  34 */
  35static ssize_t tapechar_read(struct file *, char __user *, size_t, loff_t *);
  36static ssize_t tapechar_write(struct file *, const char __user *, size_t, loff_t *);
  37static int tapechar_open(struct inode *,struct file *);
  38static int tapechar_release(struct inode *,struct file *);
  39static long tapechar_ioctl(struct file *, unsigned int, unsigned long);
  40#ifdef CONFIG_COMPAT
  41static long tapechar_compat_ioctl(struct file *, unsigned int, unsigned long);
  42#endif
  43
  44static const struct file_operations tape_fops =
  45{
  46        .owner = THIS_MODULE,
  47        .read = tapechar_read,
  48        .write = tapechar_write,
  49        .unlocked_ioctl = tapechar_ioctl,
  50#ifdef CONFIG_COMPAT
  51        .compat_ioctl = tapechar_compat_ioctl,
  52#endif
  53        .open = tapechar_open,
  54        .release = tapechar_release,
  55        .llseek = no_llseek,
  56};
  57
  58static int tapechar_major = TAPECHAR_MAJOR;
  59
  60/*
  61 * This function is called for every new tapedevice
  62 */
  63int
  64tapechar_setup_device(struct tape_device * device)
  65{
  66        char    device_name[20];
  67
  68        sprintf(device_name, "ntibm%i", device->first_minor / 2);
  69        device->nt = register_tape_dev(
  70                &device->cdev->dev,
  71                MKDEV(tapechar_major, device->first_minor),
  72                &tape_fops,
  73                device_name,
  74                "non-rewinding"
  75        );
  76        device_name[0] = 'r';
  77        device->rt = register_tape_dev(
  78                &device->cdev->dev,
  79                MKDEV(tapechar_major, device->first_minor + 1),
  80                &tape_fops,
  81                device_name,
  82                "rewinding"
  83        );
  84
  85        return 0;
  86}
  87
  88void
  89tapechar_cleanup_device(struct tape_device *device)
  90{
  91        unregister_tape_dev(&device->cdev->dev, device->rt);
  92        device->rt = NULL;
  93        unregister_tape_dev(&device->cdev->dev, device->nt);
  94        device->nt = NULL;
  95}
  96
  97static int
  98tapechar_check_idalbuffer(struct tape_device *device, size_t block_size)
  99{
 100        struct idal_buffer *new;
 101
 102        if (device->char_data.idal_buf != NULL &&
 103            device->char_data.idal_buf->size == block_size)
 104                return 0;
 105
 106        if (block_size > MAX_BLOCKSIZE) {
 107                DBF_EVENT(3, "Invalid blocksize (%zd > %d)\n",
 108                        block_size, MAX_BLOCKSIZE);
 109                return -EINVAL;
 110        }
 111
 112        /* The current idal buffer is not correct. Allocate a new one. */
 113        new = idal_buffer_alloc(block_size, 0);
 114        if (IS_ERR(new))
 115                return -ENOMEM;
 116
 117        if (device->char_data.idal_buf != NULL)
 118                idal_buffer_free(device->char_data.idal_buf);
 119
 120        device->char_data.idal_buf = new;
 121
 122        return 0;
 123}
 124
 125/*
 126 * Tape device read function
 127 */
 128static ssize_t
 129tapechar_read(struct file *filp, char __user *data, size_t count, loff_t *ppos)
 130{
 131        struct tape_device *device;
 132        struct tape_request *request;
 133        size_t block_size;
 134        int rc;
 135
 136        DBF_EVENT(6, "TCHAR:read\n");
 137        device = (struct tape_device *) filp->private_data;
 138
 139        /*
 140         * If the tape isn't terminated yet, do it now. And since we then
 141         * are at the end of the tape there wouldn't be anything to read
 142         * anyways. So we return immediately.
 143         */
 144        if(device->required_tapemarks) {
 145                return tape_std_terminate_write(device);
 146        }
 147
 148        /* Find out block size to use */
 149        if (device->char_data.block_size != 0) {
 150                if (count < device->char_data.block_size) {
 151                        DBF_EVENT(3, "TCHAR:read smaller than block "
 152                                  "size was requested\n");
 153                        return -EINVAL;
 154                }
 155                block_size = device->char_data.block_size;
 156        } else {
 157                block_size = count;
 158        }
 159
 160        rc = tapechar_check_idalbuffer(device, block_size);
 161        if (rc)
 162                return rc;
 163
 164        DBF_EVENT(6, "TCHAR:nbytes: %lx\n", block_size);
 165        /* Let the discipline build the ccw chain. */
 166        request = device->discipline->read_block(device, block_size);
 167        if (IS_ERR(request))
 168                return PTR_ERR(request);
 169        /* Execute it. */
 170        rc = tape_do_io(device, request);
 171        if (rc == 0) {
 172                rc = block_size - request->rescnt;
 173                DBF_EVENT(6, "TCHAR:rbytes:  %x\n", rc);
 174                /* Copy data from idal buffer to user space. */
 175                if (idal_buffer_to_user(device->char_data.idal_buf,
 176                                        data, rc) != 0)
 177                        rc = -EFAULT;
 178        }
 179        tape_free_request(request);
 180        return rc;
 181}
 182
 183/*
 184 * Tape device write function
 185 */
 186static ssize_t
 187tapechar_write(struct file *filp, const char __user *data, size_t count, loff_t *ppos)
 188{
 189        struct tape_device *device;
 190        struct tape_request *request;
 191        size_t block_size;
 192        size_t written;
 193        int nblocks;
 194        int i, rc;
 195
 196        DBF_EVENT(6, "TCHAR:write\n");
 197        device = (struct tape_device *) filp->private_data;
 198        /* Find out block size and number of blocks */
 199        if (device->char_data.block_size != 0) {
 200                if (count < device->char_data.block_size) {
 201                        DBF_EVENT(3, "TCHAR:write smaller than block "
 202                                  "size was requested\n");
 203                        return -EINVAL;
 204                }
 205                block_size = device->char_data.block_size;
 206                nblocks = count / block_size;
 207        } else {
 208                block_size = count;
 209                nblocks = 1;
 210        }
 211
 212        rc = tapechar_check_idalbuffer(device, block_size);
 213        if (rc)
 214                return rc;
 215
 216        DBF_EVENT(6,"TCHAR:nbytes: %lx\n", block_size);
 217        DBF_EVENT(6, "TCHAR:nblocks: %x\n", nblocks);
 218        /* Let the discipline build the ccw chain. */
 219        request = device->discipline->write_block(device, block_size);
 220        if (IS_ERR(request))
 221                return PTR_ERR(request);
 222        rc = 0;
 223        written = 0;
 224        for (i = 0; i < nblocks; i++) {
 225                /* Copy data from user space to idal buffer. */
 226                if (idal_buffer_from_user(device->char_data.idal_buf,
 227                                          data, block_size)) {
 228                        rc = -EFAULT;
 229                        break;
 230                }
 231                rc = tape_do_io(device, request);
 232                if (rc)
 233                        break;
 234                DBF_EVENT(6, "TCHAR:wbytes: %lx\n",
 235                          block_size - request->rescnt);
 236                written += block_size - request->rescnt;
 237                if (request->rescnt != 0)
 238                        break;
 239                data += block_size;
 240        }
 241        tape_free_request(request);
 242        if (rc == -ENOSPC) {
 243                /*
 244                 * Ok, the device has no more space. It has NOT written
 245                 * the block.
 246                 */
 247                if (device->discipline->process_eov)
 248                        device->discipline->process_eov(device);
 249                if (written > 0)
 250                        rc = 0;
 251
 252        }
 253
 254        /*
 255         * After doing a write we always need two tapemarks to correctly
 256         * terminate the tape (one to terminate the file, the second to
 257         * flag the end of recorded data.
 258         * Since process_eov positions the tape in front of the written
 259         * tapemark it doesn't hurt to write two marks again.
 260         */
 261        if (!rc)
 262                device->required_tapemarks = 2;
 263
 264        return rc ? rc : written;
 265}
 266
 267/*
 268 * Character frontend tape device open function.
 269 */
 270static int
 271tapechar_open (struct inode *inode, struct file *filp)
 272{
 273        struct tape_device *device;
 274        int minor, rc;
 275
 276        DBF_EVENT(6, "TCHAR:open: %i:%i\n",
 277                imajor(file_inode(filp)),
 278                iminor(file_inode(filp)));
 279
 280        if (imajor(file_inode(filp)) != tapechar_major)
 281                return -ENODEV;
 282
 283        minor = iminor(file_inode(filp));
 284        device = tape_find_device(minor / TAPE_MINORS_PER_DEV);
 285        if (IS_ERR(device)) {
 286                DBF_EVENT(3, "TCHAR:open: tape_find_device() failed\n");
 287                return PTR_ERR(device);
 288        }
 289
 290        rc = tape_open(device);
 291        if (rc == 0) {
 292                filp->private_data = device;
 293                stream_open(inode, filp);
 294        } else
 295                tape_put_device(device);
 296
 297        return rc;
 298}
 299
 300/*
 301 * Character frontend tape device release function.
 302 */
 303
 304static int
 305tapechar_release(struct inode *inode, struct file *filp)
 306{
 307        struct tape_device *device;
 308
 309        DBF_EVENT(6, "TCHAR:release: %x\n", iminor(inode));
 310        device = (struct tape_device *) filp->private_data;
 311
 312        /*
 313         * If this is the rewinding tape minor then rewind. In that case we
 314         * write all required tapemarks. Otherwise only one to terminate the
 315         * file.
 316         */
 317        if ((iminor(inode) & 1) != 0) {
 318                if (device->required_tapemarks)
 319                        tape_std_terminate_write(device);
 320                tape_mtop(device, MTREW, 1);
 321        } else {
 322                if (device->required_tapemarks > 1) {
 323                        if (tape_mtop(device, MTWEOF, 1) == 0)
 324                                device->required_tapemarks--;
 325                }
 326        }
 327
 328        if (device->char_data.idal_buf != NULL) {
 329                idal_buffer_free(device->char_data.idal_buf);
 330                device->char_data.idal_buf = NULL;
 331        }
 332        tape_release(device);
 333        filp->private_data = NULL;
 334        tape_put_device(device);
 335
 336        return 0;
 337}
 338
 339/*
 340 * Tape device io controls.
 341 */
 342static int
 343__tapechar_ioctl(struct tape_device *device,
 344                 unsigned int no, unsigned long data)
 345{
 346        int rc;
 347
 348        if (no == MTIOCTOP) {
 349                struct mtop op;
 350
 351                if (copy_from_user(&op, (char __user *) data, sizeof(op)) != 0)
 352                        return -EFAULT;
 353                if (op.mt_count < 0)
 354                        return -EINVAL;
 355
 356                /*
 357                 * Operations that change tape position should write final
 358                 * tapemarks.
 359                 */
 360                switch (op.mt_op) {
 361                        case MTFSF:
 362                        case MTBSF:
 363                        case MTFSR:
 364                        case MTBSR:
 365                        case MTREW:
 366                        case MTOFFL:
 367                        case MTEOM:
 368                        case MTRETEN:
 369                        case MTBSFM:
 370                        case MTFSFM:
 371                        case MTSEEK:
 372                                if (device->required_tapemarks)
 373                                        tape_std_terminate_write(device);
 374                        default:
 375                                ;
 376                }
 377                rc = tape_mtop(device, op.mt_op, op.mt_count);
 378
 379                if (op.mt_op == MTWEOF && rc == 0) {
 380                        if (op.mt_count > device->required_tapemarks)
 381                                device->required_tapemarks = 0;
 382                        else
 383                                device->required_tapemarks -= op.mt_count;
 384                }
 385                return rc;
 386        }
 387        if (no == MTIOCPOS) {
 388                /* MTIOCPOS: query the tape position. */
 389                struct mtpos pos;
 390
 391                rc = tape_mtop(device, MTTELL, 1);
 392                if (rc < 0)
 393                        return rc;
 394                pos.mt_blkno = rc;
 395                if (copy_to_user((char __user *) data, &pos, sizeof(pos)) != 0)
 396                        return -EFAULT;
 397                return 0;
 398        }
 399        if (no == MTIOCGET) {
 400                /* MTIOCGET: query the tape drive status. */
 401                struct mtget get;
 402
 403                memset(&get, 0, sizeof(get));
 404                get.mt_type = MT_ISUNKNOWN;
 405                get.mt_resid = 0 /* device->devstat.rescnt */;
 406                get.mt_dsreg =
 407                        ((device->char_data.block_size << MT_ST_BLKSIZE_SHIFT)
 408                         & MT_ST_BLKSIZE_MASK);
 409                /* FIXME: mt_gstat, mt_erreg, mt_fileno */
 410                get.mt_gstat = 0;
 411                get.mt_erreg = 0;
 412                get.mt_fileno = 0;
 413                get.mt_gstat  = device->tape_generic_status;
 414
 415                if (device->medium_state == MS_LOADED) {
 416                        rc = tape_mtop(device, MTTELL, 1);
 417
 418                        if (rc < 0)
 419                                return rc;
 420
 421                        if (rc == 0)
 422                                get.mt_gstat |= GMT_BOT(~0);
 423
 424                        get.mt_blkno = rc;
 425                }
 426
 427                if (copy_to_user((char __user *) data, &get, sizeof(get)) != 0)
 428                        return -EFAULT;
 429
 430                return 0;
 431        }
 432        /* Try the discipline ioctl function. */
 433        if (device->discipline->ioctl_fn == NULL)
 434                return -EINVAL;
 435        return device->discipline->ioctl_fn(device, no, data);
 436}
 437
 438static long
 439tapechar_ioctl(struct file *filp, unsigned int no, unsigned long data)
 440{
 441        struct tape_device *device;
 442        long rc;
 443
 444        DBF_EVENT(6, "TCHAR:ioct\n");
 445
 446        device = (struct tape_device *) filp->private_data;
 447        mutex_lock(&device->mutex);
 448        rc = __tapechar_ioctl(device, no, data);
 449        mutex_unlock(&device->mutex);
 450        return rc;
 451}
 452
 453#ifdef CONFIG_COMPAT
 454static long
 455tapechar_compat_ioctl(struct file *filp, unsigned int no, unsigned long data)
 456{
 457        struct tape_device *device = filp->private_data;
 458        int rval = -ENOIOCTLCMD;
 459        unsigned long argp;
 460
 461        /* The 'arg' argument of any ioctl function may only be used for
 462         * pointers because of the compat pointer conversion.
 463         * Consider this when adding new ioctls.
 464         */
 465        argp = (unsigned long) compat_ptr(data);
 466        if (device->discipline->ioctl_fn) {
 467                mutex_lock(&device->mutex);
 468                rval = device->discipline->ioctl_fn(device, no, argp);
 469                mutex_unlock(&device->mutex);
 470                if (rval == -EINVAL)
 471                        rval = -ENOIOCTLCMD;
 472        }
 473
 474        return rval;
 475}
 476#endif /* CONFIG_COMPAT */
 477
 478/*
 479 * Initialize character device frontend.
 480 */
 481int
 482tapechar_init (void)
 483{
 484        dev_t   dev;
 485
 486        if (alloc_chrdev_region(&dev, 0, 256, "tape") != 0)
 487                return -1;
 488
 489        tapechar_major = MAJOR(dev);
 490
 491        return 0;
 492}
 493
 494/*
 495 * cleanup
 496 */
 497void
 498tapechar_exit(void)
 499{
 500        unregister_chrdev_region(MKDEV(tapechar_major, 0), 256);
 501}
 502