1 /*
2 * linux/mtio.h header file for Linux. Written by H. Bergman
3 */
4
5 #ifndef _LINUX_MTIO_H
6 #define _LINUX_MTIO_H
7
8 #include <linux/ioctl.h>
9
10 /*
11 * Structures and definitions for mag tape io control commands
12 */
13
14 /* structure for MTIOCTOP - mag tape op command */
15 struct mtop {
16 short mt_op; /* operations defined below */
17 int mt_count; /* how many of them */
18 };
19
20 /* Magnetic Tape operations [Not all operations supported by all drivers]: */
21 #define MTRESET 0 /* +reset drive in case of problems */
22 #define MTFSF 1 /* forward space over FileMark,
23 * position at first record of next file
24 */
25 #define MTBSF 2 /* backward space FileMark (position before FM) */
26 #define MTFSR 3 /* forward space record */
27 #define MTBSR 4 /* backward space record */
28 #define MTWEOF 5 /* write an end-of-file record (mark) */
29 #define MTREW 6 /* rewind */
30 #define MTOFFL 7 /* rewind and put the drive offline (eject?) */
31 #define MTNOP 8 /* no op, set status only (read with MTIOCGET) */
32 #define MTRETEN 9 /* retension tape */
33 #define MTBSFM 10 /* +backward space FileMark, position at FM */
34 #define MTFSFM 11 /* +forward space FileMark, position at FM */
35 #define MTEOM 12 /* goto end of recorded media (for appending files).
36 * MTEOM positions after the last FM, ready for
37 * appending another file.
38 */
39 #define MTERASE 13 /* erase tape -- be careful! */
40
41 #define MTRAS1 14 /* run self test 1 (nondestructive) */
42 #define MTRAS2 15 /* run self test 2 (destructive) */
43 #define MTRAS3 16 /* reserved for self test 3 */
44
45 #define MTSETBLK 20 /* set block length (SCSI) */
46 #define MTSETDENSITY 21 /* set tape density (SCSI) */
47 #define MTSEEK 22 /* seek to block (Tandberg, etc.) */
48 #define MTTELL 23 /* tell block (Tandberg, etc.) */
49 #define MTSETDRVBUFFER 24 /* set the drive buffering according to SCSI-2 */
50 /* ordinary buffered operation with code 1 */
51 #define MTFSS 25 /* space forward over setmarks */
52 #define MTBSS 26 /* space backward over setmarks */
53 #define MTWSM 27 /* write setmarks */
54
55 #define MTLOCK 28 /* lock the drive door */
56 #define MTUNLOCK 29 /* unlock the drive door */
57 #define MTLOAD 30 /* execute the SCSI load command */
58 #define MTUNLOAD 31 /* execute the SCSI unload command */
59
60
61 /* structure for MTIOCGET - mag tape get status command */
62
63 struct mtget {
64 long mt_type; /* type of magtape device */
65 long mt_resid; /* residual count: (not sure)
66 * number of bytes ignored, or
67 * number of files not skipped, or
68 * number of records not skipped.
69 */
70 /* the following registers are device dependent */
71 long mt_dsreg; /* status register */
72 long mt_gstat; /* generic (device independent) status */
73 long mt_erreg; /* error register */
74 /* The next two fields are not always used */
75 daddr_t mt_fileno; /* number of current file on tape */
76 daddr_t mt_blkno; /* current block number */
77 };
78
79
80
81 /*
82 * Constants for mt_type. Not all of these are supported,
83 * and these are not all of the ones that are supported.
84 */
85 #define MT_ISUNKNOWN 0x01
86 #define MT_ISQIC02 0x02 /* Generic QIC-02 tape streamer */
87 #define MT_ISWT5150 0x03 /* Wangtek 5150EQ, QIC-150, QIC-02 */
88 #define MT_ISARCHIVE_5945L2 0x04 /* Archive 5945L-2, QIC-24, QIC-02? */
89 #define MT_ISCMSJ500 0x05 /* CMS Jumbo 500 (QIC-02?) */
90 #define MT_ISTDC3610 0x06 /* Tandberg 6310, QIC-24 */
91 #define MT_ISARCHIVE_VP60I 0x07 /* Archive VP60i, QIC-02 */
92 #define MT_ISARCHIVE_2150L 0x08 /* Archive Viper 2150L */
93 #define MT_ISARCHIVE_2060L 0x09 /* Archive Viper 2060L */
94 #define MT_ISARCHIVESC499 0x0A /* Archive SC-499 QIC-36 controller */
95 #define MT_ISQIC02_ALL_FEATURES 0x0F /* Generic QIC-02 with all features */
96 #define MT_ISWT5099EEN24 0x11 /* Wangtek 5099-een24, 60MB, QIC-24 */
97 #define MT_ISTEAC_MT2ST 0x12 /* Teac MT-2ST 155mb drive, Teac DC-1 card (Wangtek type) */
98 #define MT_ISEVEREX_FT40A 0x32 /* Everex FT40A (QIC-40) */
99 #define MT_ISDDS1 0x51 /* DDS device without partitions */
100 #define MT_ISDDS2 0x52 /* DDS device with partitions */
101 #define MT_ISSCSI1 0x71 /* Generic ANSI SCSI-1 tape unit */
102 #define MT_ISSCSI2 0x72 /* Generic ANSI SCSI-2 tape unit */
103
104 /* QIC-40/80/3010/3020 ftape supported drives.
105 * 20bit vendor ID + 0x800000 (see vendors.h in ftape distribution)
106 */
107 #define MT_ISFTAPE_UNKNOWN 0x800000 /* obsolete */
108 #define MT_ISFTAPE_FLAG 0x800000
109
110 struct mt_tape_info {
111 long t_type; /* device type id (mt_type) */
112 char *t_name; /* descriptive name */
113 };
114
115 #define MT_TAPE_INFO { \
116 {MT_ISUNKNOWN, "Unknown type of tape device"}, \
117 {MT_ISQIC02, "Generic QIC-02 tape streamer"}, \
118 {MT_ISWT5150, "Wangtek 5150, QIC-150"}, \
119 {MT_ISARCHIVE_5945L2, "Archive 5945L-2"}, \
120 {MT_ISCMSJ500, "CMS Jumbo 500"}, \
121 {MT_ISTDC3610, "Tandberg TDC 3610, QIC-24"}, \
122 {MT_ISARCHIVE_VP60I, "Archive VP60i, QIC-02"}, \
123 {MT_ISARCHIVE_2150L, "Archive Viper 2150L"}, \
124 {MT_ISARCHIVE_2060L, "Archive Viper 2060L"}, \
125 {MT_ISARCHIVESC499, "Archive SC-499 QIC-36 controller"}, \
126 {MT_ISQIC02_ALL_FEATURES, "Generic QIC-02 tape, all features"}, \
127 {MT_ISWT5099EEN24, "Wangtek 5099-een24, 60MB"}, \
128 {MT_ISTEAC_MT2ST, "Teac MT-2ST 155mb data cassette drive"}, \
129 {MT_ISEVEREX_FT40A, "Everex FT40A, QIC-40"}, \
130 {MT_ISSCSI1, "Generic SCSI-1 tape"}, \
131 {MT_ISSCSI2, "Generic SCSI-2 tape"}, \
132 {0, NULL} \
133 }
134
135
136 /* structure for MTIOCPOS - mag tape get position command */
137
138 struct mtpos {
139 long mt_blkno; /* current block number */
140 };
141
142
143 /* structure for MTIOCGETCONFIG/MTIOCSETCONFIG primarily intended
144 * as an interim solution for QIC-02 until DDI is fully implemented.
145 */
146 struct mtconfiginfo {
147 long mt_type; /* drive type */
148 long ifc_type; /* interface card type */
149 unsigned short irqnr; /* IRQ number to use */
150 unsigned short dmanr; /* DMA channel to use */
151 unsigned short port; /* IO port base address */
152
153 unsigned long debug; /* debugging flags */
154
155 unsigned have_dens:1;
156 unsigned have_bsf:1;
157 unsigned have_fsr:1;
158 unsigned have_bsr:1;
159 unsigned have_eod:1;
160 unsigned have_seek:1;
161 unsigned have_tell:1;
162 unsigned have_ras1:1;
163 unsigned have_ras2:1;
164 unsigned have_ras3:1;
165 unsigned have_qfa:1;
166
167 unsigned pad1:5;
168 char reserved[10];
169 };
170
171
172 /* mag tape io control commands */
173 #define MTIOCTOP _IOW('m', 1, struct mtop) /* do a mag tape op */
174 #define MTIOCGET _IOR('m', 2, struct mtget) /* get tape status */
175 #define MTIOCPOS _IOR('m', 3, struct mtpos) /* get tape position */
176
177 /* The next two are used by the QIC-02 driver for runtime reconfiguration.
178 * See tpqic02.h for struct mtconfiginfo.
179 */
180 #define MTIOCGETCONFIG _IOR('m', 4, struct mtconfiginfo) /* get tape config */
181 #define MTIOCSETCONFIG _IOW('m', 5, struct mtconfiginfo) /* set tape config */
182
183
184 /* Generic Mag Tape (device independent) status macros for examining
185 * mt_gstat -- HP-UX compatible.
186 * There is room for more generic status bits here, but I don't
187 * know which of them are reserved. At least three or so should
188 * be added to make this really useful.
189 */
190 #define GMT_EOF(x) ((x) & 0x80000000)
191 #define GMT_BOT(x) ((x) & 0x40000000)
192 #define GMT_EOT(x) ((x) & 0x20000000)
193 #define GMT_SM(x) ((x) & 0x10000000) /* DDS setmark */
194 #define GMT_EOD(x) ((x) & 0x08000000) /* DDS EOD */
195 #define GMT_WR_PROT(x) ((x) & 0x04000000)
196 /* #define GMT_ ? ((x) & 0x02000000) */
197 #define GMT_ONLINE(x) ((x) & 0x01000000)
198 #define GMT_D_6250(x) ((x) & 0x00800000)
199 #define GMT_D_1600(x) ((x) & 0x00400000)
200 #define GMT_D_800(x) ((x) & 0x00200000)
201 /* #define GMT_ ? ((x) & 0x00100000) */
202 /* #define GMT_ ? ((x) & 0x00080000) */
203 #define GMT_DR_OPEN(x) ((x) & 0x00040000) /* door open (no tape) */
204 /* #define GMT_ ? ((x) & 0x00020000) */
205 #define GMT_IM_REP_EN(x) ((x) & 0x00010000) /* immediate report mode */
206 /* 16 generic status bits unused */
207
208 /* DDS drives have 'setmarks', sort of like filemarks but used to group
209 * files, rather than blocks. Not used. Not supported.
210 * I think DDS drives are DAT drives.
211 */
212
213 /* SCSI-tape specific definitions */
214 #define MT_ST_BLKSIZE_SHIFT 0
215 #define MT_ST_BLKSIZE_MASK 0xffffff
216 #define MT_ST_DENSITY_SHIFT 24
217 #define MT_ST_DENSITY_MASK 0xff000000
218
219 #define MT_ST_SOFTERR_SHIFT 0
220 #define MT_ST_SOFTERR_MASK 0xffff
221
222 #define MT_ST_OPTIONS 0xf0000000
223 #define MT_ST_BOOLEANS 0x10000000
224 #define MT_ST_WRITE_THRESHOLD 0x20000000
225 #define MT_ST_BUFFER_WRITES 0x1
226 #define MT_ST_ASYNC_WRITES 0x2
227 #define MT_ST_READ_AHEAD 0x4
228 #define MT_ST_DEBUGGING 0x8
229 #define MT_ST_TWO_FM 0x10
230 #define MT_ST_FAST_MTEOM 0x20
231 #define MT_ST_AUTO_LOCK 0x40
232
233 #endif /* _LINUX_MTIO_H */