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