linux/include/uapi/linux/mtio.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
   2/* 
   3 * linux/mtio.h header file for Linux. Written by H. Bergman
   4 *
   5 * Modified for special ioctls provided by zftape in September 1997
   6 * by C.-J. Heine.
   7 */
   8
   9#ifndef _LINUX_MTIO_H
  10#define _LINUX_MTIO_H
  11
  12#include <linux/types.h>
  13#include <linux/ioctl.h>
  14
  15/*
  16 * Structures and definitions for mag tape io control commands
  17 */
  18
  19/* structure for MTIOCTOP - mag tape op command */
  20struct  mtop {
  21        short   mt_op;          /* operations defined below */
  22        int     mt_count;       /* how many of them */
  23};
  24
  25/* Magnetic Tape operations [Not all operations supported by all drivers]: */
  26#define MTRESET 0       /* +reset drive in case of problems */
  27#define MTFSF   1       /* forward space over FileMark,
  28                         * position at first record of next file 
  29                         */
  30#define MTBSF   2       /* backward space FileMark (position before FM) */
  31#define MTFSR   3       /* forward space record */
  32#define MTBSR   4       /* backward space record */
  33#define MTWEOF  5       /* write an end-of-file record (mark) */
  34#define MTREW   6       /* rewind */
  35#define MTOFFL  7       /* rewind and put the drive offline (eject?) */
  36#define MTNOP   8       /* no op, set status only (read with MTIOCGET) */
  37#define MTRETEN 9       /* retension tape */
  38#define MTBSFM  10      /* +backward space FileMark, position at FM */
  39#define MTFSFM  11      /* +forward space FileMark, position at FM */
  40#define MTEOM   12      /* goto end of recorded media (for appending files).
  41                         * MTEOM positions after the last FM, ready for
  42                         * appending another file.
  43                         */
  44#define MTERASE 13      /* erase tape -- be careful! */
  45
  46#define MTRAS1  14      /* run self test 1 (nondestructive) */
  47#define MTRAS2  15      /* run self test 2 (destructive) */
  48#define MTRAS3  16      /* reserved for self test 3 */
  49
  50#define MTSETBLK 20     /* set block length (SCSI) */
  51#define MTSETDENSITY 21 /* set tape density (SCSI) */
  52#define MTSEEK  22      /* seek to block (Tandberg, etc.) */
  53#define MTTELL  23      /* tell block (Tandberg, etc.) */
  54#define MTSETDRVBUFFER 24 /* set the drive buffering according to SCSI-2 */
  55                        /* ordinary buffered operation with code 1 */
  56#define MTFSS   25      /* space forward over setmarks */
  57#define MTBSS   26      /* space backward over setmarks */
  58#define MTWSM   27      /* write setmarks */
  59
  60#define MTLOCK  28      /* lock the drive door */
  61#define MTUNLOCK 29     /* unlock the drive door */
  62#define MTLOAD  30      /* execute the SCSI load command */
  63#define MTUNLOAD 31     /* execute the SCSI unload command */
  64#define MTCOMPRESSION 32/* control compression with SCSI mode page 15 */
  65#define MTSETPART 33    /* Change the active tape partition */
  66#define MTMKPART  34    /* Format the tape with one or two partitions */
  67#define MTWEOFI 35      /* write an end-of-file record (mark) in immediate mode */
  68
  69/* structure for MTIOCGET - mag tape get status command */
  70
  71struct  mtget {
  72        long    mt_type;        /* type of magtape device */
  73        long    mt_resid;       /* residual count: (not sure)
  74                                 *      number of bytes ignored, or
  75                                 *      number of files not skipped, or
  76                                 *      number of records not skipped.
  77                                 */
  78        /* the following registers are device dependent */
  79        long    mt_dsreg;       /* status register */
  80        long    mt_gstat;       /* generic (device independent) status */
  81        long    mt_erreg;       /* error register */
  82        /* The next two fields are not always used */
  83        __kernel_daddr_t mt_fileno;     /* number of current file on tape */
  84        __kernel_daddr_t mt_blkno;      /* current block number */
  85};
  86
  87
  88
  89/*
  90 * Constants for mt_type. Not all of these are supported,
  91 * and these are not all of the ones that are supported.
  92 */
  93#define MT_ISUNKNOWN            0x01
  94#define MT_ISQIC02              0x02    /* Generic QIC-02 tape streamer */
  95#define MT_ISWT5150             0x03    /* Wangtek 5150EQ, QIC-150, QIC-02 */
  96#define MT_ISARCHIVE_5945L2     0x04    /* Archive 5945L-2, QIC-24, QIC-02? */
  97#define MT_ISCMSJ500            0x05    /* CMS Jumbo 500 (QIC-02?) */
  98#define MT_ISTDC3610            0x06    /* Tandberg 6310, QIC-24 */
  99#define MT_ISARCHIVE_VP60I      0x07    /* Archive VP60i, QIC-02 */
 100#define MT_ISARCHIVE_2150L      0x08    /* Archive Viper 2150L */
 101#define MT_ISARCHIVE_2060L      0x09    /* Archive Viper 2060L */
 102#define MT_ISARCHIVESC499       0x0A    /* Archive SC-499 QIC-36 controller */
 103#define MT_ISQIC02_ALL_FEATURES 0x0F    /* Generic QIC-02 with all features */
 104#define MT_ISWT5099EEN24        0x11    /* Wangtek 5099-een24, 60MB, QIC-24 */
 105#define MT_ISTEAC_MT2ST         0x12    /* Teac MT-2ST 155mb drive, Teac DC-1 card (Wangtek type) */
 106#define MT_ISEVEREX_FT40A       0x32    /* Everex FT40A (QIC-40) */
 107#define MT_ISDDS1               0x51    /* DDS device without partitions */
 108#define MT_ISDDS2               0x52    /* DDS device with partitions */
 109#define MT_ISONSTREAM_SC        0x61   /* OnStream SCSI tape drives (SC-x0)
 110                                          and SCSI emulated (DI, DP, USB) */
 111#define MT_ISSCSI1              0x71    /* Generic ANSI SCSI-1 tape unit */
 112#define MT_ISSCSI2              0x72    /* Generic ANSI SCSI-2 tape unit */
 113
 114/* QIC-40/80/3010/3020 ftape supported drives.
 115 * 20bit vendor ID + 0x800000 (see ftape-vendors.h)
 116 */
 117#define MT_ISFTAPE_UNKNOWN      0x800000 /* obsolete */
 118#define MT_ISFTAPE_FLAG 0x800000
 119
 120
 121/* structure for MTIOCPOS - mag tape get position command */
 122
 123struct  mtpos {
 124        long    mt_blkno;       /* current block number */
 125};
 126
 127
 128/* mag tape io control commands */
 129#define MTIOCTOP        _IOW('m', 1, struct mtop)       /* do a mag tape op */
 130#define MTIOCGET        _IOR('m', 2, struct mtget)      /* get tape status */
 131#define MTIOCPOS        _IOR('m', 3, struct mtpos)      /* get tape position */
 132
 133
 134/* Generic Mag Tape (device independent) status macros for examining
 135 * mt_gstat -- HP-UX compatible.
 136 * There is room for more generic status bits here, but I don't
 137 * know which of them are reserved. At least three or so should
 138 * be added to make this really useful.
 139 */
 140#define GMT_EOF(x)              ((x) & 0x80000000)
 141#define GMT_BOT(x)              ((x) & 0x40000000)
 142#define GMT_EOT(x)              ((x) & 0x20000000)
 143#define GMT_SM(x)               ((x) & 0x10000000)  /* DDS setmark */
 144#define GMT_EOD(x)              ((x) & 0x08000000)  /* DDS EOD */
 145#define GMT_WR_PROT(x)          ((x) & 0x04000000)
 146/* #define GMT_ ?               ((x) & 0x02000000) */
 147#define GMT_ONLINE(x)           ((x) & 0x01000000)
 148#define GMT_D_6250(x)           ((x) & 0x00800000)
 149#define GMT_D_1600(x)           ((x) & 0x00400000)
 150#define GMT_D_800(x)            ((x) & 0x00200000)
 151/* #define GMT_ ?               ((x) & 0x00100000) */
 152/* #define GMT_ ?               ((x) & 0x00080000) */
 153#define GMT_DR_OPEN(x)          ((x) & 0x00040000)  /* door open (no tape) */
 154/* #define GMT_ ?               ((x) & 0x00020000) */
 155#define GMT_IM_REP_EN(x)        ((x) & 0x00010000)  /* immediate report mode */
 156#define GMT_CLN(x)              ((x) & 0x00008000)  /* cleaning requested */
 157/* 15 generic status bits unused */
 158
 159
 160/* SCSI-tape specific definitions */
 161/* Bitfield shifts in the status  */
 162#define MT_ST_BLKSIZE_SHIFT     0
 163#define MT_ST_BLKSIZE_MASK      0xffffff
 164#define MT_ST_DENSITY_SHIFT     24
 165#define MT_ST_DENSITY_MASK      0xff000000
 166
 167#define MT_ST_SOFTERR_SHIFT     0
 168#define MT_ST_SOFTERR_MASK      0xffff
 169
 170/* Bitfields for the MTSETDRVBUFFER ioctl */
 171#define MT_ST_OPTIONS           0xf0000000
 172#define MT_ST_BOOLEANS          0x10000000
 173#define MT_ST_SETBOOLEANS       0x30000000
 174#define MT_ST_CLEARBOOLEANS     0x40000000
 175#define MT_ST_WRITE_THRESHOLD   0x20000000
 176#define MT_ST_DEF_BLKSIZE       0x50000000
 177#define MT_ST_DEF_OPTIONS       0x60000000
 178#define MT_ST_TIMEOUTS          0x70000000
 179#define MT_ST_SET_TIMEOUT       (MT_ST_TIMEOUTS | 0x000000)
 180#define MT_ST_SET_LONG_TIMEOUT  (MT_ST_TIMEOUTS | 0x100000)
 181#define MT_ST_SET_CLN           0x80000000
 182
 183#define MT_ST_BUFFER_WRITES     0x1
 184#define MT_ST_ASYNC_WRITES      0x2
 185#define MT_ST_READ_AHEAD        0x4
 186#define MT_ST_DEBUGGING         0x8
 187#define MT_ST_TWO_FM            0x10
 188#define MT_ST_FAST_MTEOM        0x20
 189#define MT_ST_AUTO_LOCK         0x40
 190#define MT_ST_DEF_WRITES        0x80
 191#define MT_ST_CAN_BSR           0x100
 192#define MT_ST_NO_BLKLIMS        0x200
 193#define MT_ST_CAN_PARTITIONS    0x400
 194#define MT_ST_SCSI2LOGICAL      0x800
 195#define MT_ST_SYSV              0x1000
 196#define MT_ST_NOWAIT            0x2000
 197#define MT_ST_SILI              0x4000
 198#define MT_ST_NOWAIT_EOF        0x8000
 199
 200/* The mode parameters to be controlled. Parameter chosen with bits 20-28 */
 201#define MT_ST_CLEAR_DEFAULT     0xfffff
 202#define MT_ST_DEF_DENSITY       (MT_ST_DEF_OPTIONS | 0x100000)
 203#define MT_ST_DEF_COMPRESSION   (MT_ST_DEF_OPTIONS | 0x200000)
 204#define MT_ST_DEF_DRVBUFFER     (MT_ST_DEF_OPTIONS | 0x300000)
 205
 206/* The offset for the arguments for the special HP changer load command. */
 207#define MT_ST_HPLOADER_OFFSET 10000
 208
 209#endif /* _LINUX_MTIO_H */
 210