1/* 2 * linux/mtio.h header file for Linux. Written by H. Bergman 3 * 4 * Modified for special ioctls provided by zftape in September 1997 5 * by C.-J. Heine. 6 */ 7 8#ifndef _LINUX_MTIO_H 9#define _LINUX_MTIO_H 10 11#include <linux/types.h> 12#include <linux/ioctl.h> 13#include <linux/qic117.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 68/* structure for MTIOCGET - mag tape get status command */ 69 70struct mtget { 71 long mt_type; /* type of magtape device */ 72 long mt_resid; /* residual count: (not sure) 73 * number of bytes ignored, or 74 * number of files not skipped, or 75 * number of records not skipped. 76 */ 77 /* the following registers are device dependent */ 78 long mt_dsreg; /* status register */ 79 long mt_gstat; /* generic (device independent) status */ 80 long mt_erreg; /* error register */ 81 /* The next two fields are not always used */ 82 __kernel_daddr_t mt_fileno; /* number of current file on tape */ 83 __kernel_daddr_t mt_blkno; /* current block number */ 84}; 85 86 87 88/* 89 * Constants for mt_type. Not all of these are supported, 90 * and these are not all of the ones that are supported. 91 */ 92#define MT_ISUNKNOWN 0x01 93#define MT_ISQIC02 0x02 /* Generic QIC-02 tape streamer */ 94#define MT_ISWT5150 0x03 /* Wangtek 5150EQ, QIC-150, QIC-02 */ 95#define MT_ISARCHIVE_5945L2 0x04 /* Archive 5945L-2, QIC-24, QIC-02? */ 96#define MT_ISCMSJ500 0x05 /* CMS Jumbo 500 (QIC-02?) */ 97#define MT_ISTDC3610 0x06 /* Tandberg 6310, QIC-24 */ 98#define MT_ISARCHIVE_VP60I 0x07 /* Archive VP60i, QIC-02 */ 99#define MT_ISARCHIVE_2150L 0x08 /* Archive Viper 2150L */ 100#define MT_ISARCHIVE_2060L 0x09 /* Archive Viper 2060L */ 101#define MT_ISARCHIVESC499 0x0A /* Archive SC-499 QIC-36 controller */ 102#define MT_ISQIC02_ALL_FEATURES 0x0F /* Generic QIC-02 with all features */ 103#define MT_ISWT5099EEN24 0x11 /* Wangtek 5099-een24, 60MB, QIC-24 */ 104#define MT_ISTEAC_MT2ST 0x12 /* Teac MT-2ST 155mb drive, Teac DC-1 card (Wangtek type) */ 105#define MT_ISEVEREX_FT40A 0x32 /* Everex FT40A (QIC-40) */ 106#define MT_ISDDS1 0x51 /* DDS device without partitions */ 107#define MT_ISDDS2 0x52 /* DDS device with partitions */ 108#define MT_ISONSTREAM_SC 0x61 /* OnStream SCSI tape drives (SC-x0) 109 and SCSI emulated (DI, DP, USB) */ 110#define MT_ISSCSI1 0x71 /* Generic ANSI SCSI-1 tape unit */ 111#define MT_ISSCSI2 0x72 /* Generic ANSI SCSI-2 tape unit */ 112 113/* QIC-40/80/3010/3020 ftape supported drives. 114 * 20bit vendor ID + 0x800000 (see ftape-vendors.h) 115 */ 116#define MT_ISFTAPE_UNKNOWN 0x800000 /* obsolete */ 117#define MT_ISFTAPE_FLAG 0x800000 118 119struct mt_tape_info { 120 long t_type; /* device type id (mt_type) */ 121 char *t_name; /* descriptive name */ 122}; 123 124#define MT_TAPE_INFO { \ 125 {MT_ISUNKNOWN, "Unknown type of tape device"}, \ 126 {MT_ISQIC02, "Generic QIC-02 tape streamer"}, \ 127 {MT_ISWT5150, "Wangtek 5150, QIC-150"}, \ 128 {MT_ISARCHIVE_5945L2, "Archive 5945L-2"}, \ 129 {MT_ISCMSJ500, "CMS Jumbo 500"}, \ 130 {MT_ISTDC3610, "Tandberg TDC 3610, QIC-24"}, \ 131 {MT_ISARCHIVE_VP60I, "Archive VP60i, QIC-02"}, \ 132 {MT_ISARCHIVE_2150L, "Archive Viper 2150L"}, \ 133 {MT_ISARCHIVE_2060L, "Archive Viper 2060L"}, \ 134 {MT_ISARCHIVESC499, "Archive SC-499 QIC-36 controller"}, \ 135 {MT_ISQIC02_ALL_FEATURES, "Generic QIC-02 tape, all features"}, \ 136 {MT_ISWT5099EEN24, "Wangtek 5099-een24, 60MB"}, \ 137 {MT_ISTEAC_MT2ST, "Teac MT-2ST 155mb data cassette drive"}, \ 138 {MT_ISEVEREX_FT40A, "Everex FT40A, QIC-40"}, \ 139 {MT_ISONSTREAM_SC, "OnStream SC-, DI-, DP-, or USB tape drive"}, \ 140 {MT_ISSCSI1, "Generic SCSI-1 tape"}, \ 141 {MT_ISSCSI2, "Generic SCSI-2 tape"}, \ 142 {0, NULL} \ 143} 144 145 146/* structure for MTIOCPOS - mag tape get position command */ 147 148struct mtpos { 149 long mt_blkno; /* current block number */ 150}; 151 152 153/* structure for MTIOCGETCONFIG/MTIOCSETCONFIG primarily intended 154 * as an interim solution for QIC-02 until DDI is fully implemented. 155 */ 156struct mtconfiginfo { 157 long mt_type; /* drive type */ 158 long ifc_type; /* interface card type */ 159 unsigned short irqnr; /* IRQ number to use */ 160 unsigned short dmanr; /* DMA channel to use */ 161 unsigned short port; /* IO port base address */ 162 163 unsigned long debug; /* debugging flags */ 164 165 unsigned have_dens:1; 166 unsigned have_bsf:1; 167 unsigned have_fsr:1; 168 unsigned have_bsr:1; 169 unsigned have_eod:1; 170 unsigned have_seek:1; 171 unsigned have_tell:1; 172 unsigned have_ras1:1; 173 unsigned have_ras2:1; 174 unsigned have_ras3:1; 175 unsigned have_qfa:1; 176 177 unsigned pad1:5; 178 char reserved[10]; 179}; 180 181/* structure for MTIOCVOLINFO, query information about the volume 182 * currently positioned at (zftape) 183 */ 184struct mtvolinfo { 185 unsigned int mt_volno; /* vol-number */ 186 unsigned int mt_blksz; /* blocksize used when recording */ 187 unsigned int mt_rawsize; /* raw tape space consumed, in kb */ 188 unsigned int mt_size; /* volume size after decompression, in kb */ 189 unsigned int mt_cmpr:1; /* this volume has been compressed */ 190}; 191 192/* raw access to a floppy drive, read and write an arbitrary segment. 193 * For ftape/zftape to support formatting etc. 194 */ 195#define MT_FT_RD_SINGLE 0 196#define MT_FT_RD_AHEAD 1 197#define MT_FT_WR_ASYNC 0 /* start tape only when all buffers are full */ 198#define MT_FT_WR_MULTI 1 /* start tape, continue until buffers are empty */ 199#define MT_FT_WR_SINGLE 2 /* write a single segment and stop afterwards */ 200#define MT_FT_WR_DELETE 3 /* write deleted data marks, one segment at time */ 201 202struct mtftseg 203{ 204 unsigned mt_segno; /* the segment to read or write */ 205 unsigned mt_mode; /* modes for read/write (sync/async etc.) */ 206 int mt_result; /* result of r/w request, not of the ioctl */ 207 void *mt_data; /* User space buffer: must be 29kb */ 208}; 209 210/* get tape capacity (ftape/zftape) 211 */ 212struct mttapesize { 213 unsigned long mt_capacity; /* entire, uncompressed capacity 214 * of a cartridge 215 */ 216 unsigned long mt_used; /* what has been used so far, raw 217 * uncompressed amount 218 */ 219}; 220 221/* possible values of the ftfmt_op field 222 */ 223#define FTFMT_SET_PARMS 1 /* set software parms */ 224#define FTFMT_GET_PARMS 2 /* get software parms */ 225#define FTFMT_FORMAT_TRACK 3 /* start formatting a tape track */ 226#define FTFMT_STATUS 4 /* monitor formatting a tape track */ 227#define FTFMT_VERIFY 5 /* verify the given segment */ 228 229struct ftfmtparms { 230 unsigned char ft_qicstd; /* QIC-40/QIC-80/QIC-3010/QIC-3020 */ 231 unsigned char ft_fmtcode; /* Refer to the QIC specs */ 232 unsigned char ft_fhm; /* floppy head max */ 233 unsigned char ft_ftm; /* floppy track max */ 234 unsigned short ft_spt; /* segments per track */ 235 unsigned short ft_tpc; /* tracks per cartridge */ 236}; 237 238struct ftfmttrack { 239 unsigned int ft_track; /* track to format */ 240 unsigned char ft_gap3; /* size of gap3, for FORMAT_TRK */ 241}; 242 243struct ftfmtstatus { 244 unsigned int ft_segment; /* segment currently being formatted */ 245}; 246 247struct ftfmtverify { 248 unsigned int ft_segment; /* segment to verify */ 249 unsigned long ft_bsm; /* bsm as result of VERIFY cmd */ 250}; 251 252struct mtftformat { 253 unsigned int fmt_op; /* operation to perform */ 254 union fmt_arg { 255 struct ftfmtparms fmt_parms; /* format parameters */ 256 struct ftfmttrack fmt_track; /* ctrl while formatting */ 257 struct ftfmtstatus fmt_status; 258 struct ftfmtverify fmt_verify; /* for verifying */ 259 } fmt_arg; 260}; 261 262struct mtftcmd { 263 unsigned int ft_wait_before; /* timeout to wait for drive to get ready 264 * before command is sent. Milliseconds 265 */ 266 qic117_cmd_t ft_cmd; /* command to send */ 267 unsigned char ft_parm_cnt; /* zero: no parm is sent. */ 268 unsigned char ft_parms[3]; /* parameter(s) to send to 269 * the drive. The parms are nibbles 270 * driver sends cmd + 2 step pulses */ 271 unsigned int ft_result_bits; /* if non zero, number of bits 272 * returned by the tape drive 273 */ 274 unsigned int ft_result; /* the result returned by the tape drive*/ 275 unsigned int ft_wait_after; /* timeout to wait for drive to get ready 276 * after command is sent. 0: don't wait */ 277 int ft_status; /* status returned by ready wait 278 * undefined if timeout was 0. 279 */ 280 int ft_error; /* error code if error status was set by 281 * command 282 */ 283}; 284 285/* mag tape io control commands */ 286#define MTIOCTOP _IOW('m', 1, struct mtop) /* do a mag tape op */ 287#define MTIOCGET _IOR('m', 2, struct mtget) /* get tape status */ 288#define MTIOCPOS _IOR('m', 3, struct mtpos) /* get tape position */ 289 290/* The next two are used by the QIC-02 driver for runtime reconfiguration. 291 * See tpqic02.h for struct mtconfiginfo. 292 */ 293#define MTIOCGETCONFIG _IOR('m', 4, struct mtconfiginfo) /* get tape config */ 294#define MTIOCSETCONFIG _IOW('m', 5, struct mtconfiginfo) /* set tape config */ 295 296/* the next six are used by the floppy ftape drivers and its frontends 297 * sorry, but MTIOCTOP commands are write only. 298 */ 299#define MTIOCRDFTSEG _IOWR('m', 6, struct mtftseg) /* read a segment */ 300#define MTIOCWRFTSEG _IOWR('m', 7, struct mtftseg) /* write a segment */ 301#define MTIOCVOLINFO _IOR('m', 8, struct mtvolinfo) /* info about volume */ 302#define MTIOCGETSIZE _IOR('m', 9, struct mttapesize)/* get cartridge size*/ 303#define MTIOCFTFORMAT _IOWR('m', 10, struct mtftformat) /* format ftape */ 304#define MTIOCFTCMD _IOWR('m', 11, struct mtftcmd) /* send QIC-117 cmd */ 305 306/* Generic Mag Tape (device independent) status macros for examining 307 * mt_gstat -- HP-UX compatible. 308 * There is room for more generic status bits here, but I don't 309 * know which of them are reserved. At least three or so should 310 * be added to make this really useful. 311 */ 312#define GMT_EOF(x) ((x) & 0x80000000) 313#define GMT_BOT(x) ((x) & 0x40000000) 314#define GMT_EOT(x) ((x) & 0x20000000) 315#define GMT_SM(x) ((x) & 0x10000000) /* DDS setmark */ 316#define GMT_EOD(x) ((x) & 0x08000000) /* DDS EOD */ 317#define GMT_WR_PROT(x) ((x) & 0x04000000) 318/* #define GMT_ ? ((x) & 0x02000000) */ 319#define GMT_ONLINE(x) ((x) & 0x01000000) 320#define GMT_D_6250(x) ((x) & 0x00800000) 321#define GMT_D_1600(x) ((x) & 0x00400000) 322#define GMT_D_800(x) ((x) & 0x00200000) 323/* #define GMT_ ? ((x) & 0x00100000) */ 324/* #define GMT_ ? ((x) & 0x00080000) */ 325#define GMT_DR_OPEN(x) ((x) & 0x00040000) /* door open (no tape) */ 326/* #define GMT_ ? ((x) & 0x00020000) */ 327#define GMT_IM_REP_EN(x) ((x) & 0x00010000) /* immediate report mode */ 328#define GMT_CLN(x) ((x) & 0x00008000) /* cleaning requested */ 329/* 15 generic status bits unused */ 330 331 332/* SCSI-tape specific definitions */ 333/* Bitfield shifts in the status */ 334#define MT_ST_BLKSIZE_SHIFT 0 335#define MT_ST_BLKSIZE_MASK 0xffffff 336#define MT_ST_DENSITY_SHIFT 24 337#define MT_ST_DENSITY_MASK 0xff000000 338 339#define MT_ST_SOFTERR_SHIFT 0 340#define MT_ST_SOFTERR_MASK 0xffff 341 342/* Bitfields for the MTSETDRVBUFFER ioctl */ 343#define MT_ST_OPTIONS 0xf0000000 344#define MT_ST_BOOLEANS 0x10000000 345#define MT_ST_SETBOOLEANS 0x30000000 346#define MT_ST_CLEARBOOLEANS 0x40000000 347#define MT_ST_WRITE_THRESHOLD 0x20000000 348#define MT_ST_DEF_BLKSIZE 0x50000000 349#define MT_ST_DEF_OPTIONS 0x60000000 350#define MT_ST_TIMEOUTS 0x70000000 351#define MT_ST_SET_TIMEOUT (MT_ST_TIMEOUTS | 0x000000) 352#define MT_ST_SET_LONG_TIMEOUT (MT_ST_TIMEOUTS | 0x100000) 353#define MT_ST_SET_CLN 0x80000000 354 355#define MT_ST_BUFFER_WRITES 0x1 356#define MT_ST_ASYNC_WRITES 0x2 357#define MT_ST_READ_AHEAD 0x4 358#define MT_ST_DEBUGGING 0x8 359#define MT_ST_TWO_FM 0x10 360#define MT_ST_FAST_MTEOM 0x20 361#define MT_ST_AUTO_LOCK 0x40 362#define MT_ST_DEF_WRITES 0x80 363#define MT_ST_CAN_BSR 0x100 364#define MT_ST_NO_BLKLIMS 0x200 365#define MT_ST_CAN_PARTITIONS 0x400 366#define MT_ST_SCSI2LOGICAL 0x800 367#define MT_ST_SYSV 0x1000 368#define MT_ST_NOWAIT 0x2000 369 370/* The mode parameters to be controlled. Parameter chosen with bits 20-28 */ 371#define MT_ST_CLEAR_DEFAULT 0xfffff 372#define MT_ST_DEF_DENSITY (MT_ST_DEF_OPTIONS | 0x100000) 373#define MT_ST_DEF_COMPRESSION (MT_ST_DEF_OPTIONS | 0x200000) 374#define MT_ST_DEF_DRVBUFFER (MT_ST_DEF_OPTIONS | 0x300000) 375 376/* The offset for the arguments for the special HP changer load command. */ 377#define MT_ST_HPLOADER_OFFSET 10000 378 379#endif /* _LINUX_MTIO_H */ 380