USB: small update to Documentation/usb/acm.txt
[linux-2.6] / drivers / scsi / dpt / dptsig.h
1 /*      BSDI dptsig.h,v 1.7 1998/06/03 19:15:00 karels Exp      */
2
3 /*
4  * Copyright (c) 1996-1999 Distributed Processing Technology Corporation
5  * All rights reserved.
6  *
7  * Redistribution and use in source form, with or without modification, are
8  * permitted provided that redistributions of source code must retain the
9  * above copyright notice, this list of conditions and the following disclaimer.
10  *
11  * This software is provided `as is' by Distributed Processing Technology and
12  * any express or implied warranties, including, but not limited to, the
13  * implied warranties of merchantability and fitness for a particular purpose,
14  * are disclaimed. In no event shall Distributed Processing Technology be
15  * liable for any direct, indirect, incidental, special, exemplary or
16  * consequential damages (including, but not limited to, procurement of
17  * substitute goods or services; loss of use, data, or profits; or business
18  * interruptions) however caused and on any theory of liability, whether in
19  * contract, strict liability, or tort (including negligence or otherwise)
20  * arising in any way out of the use of this driver software, even if advised
21  * of the possibility of such damage.
22  *
23  */
24
25 #ifndef __DPTSIG_H_
26 #define __DPTSIG_H_
27 #ifdef _SINIX_ADDON
28 #include "dpt.h"
29 #endif
30 /* DPT SIGNATURE SPEC AND HEADER FILE                           */
31 /* Signature Version 1 (sorry no 'A')                           */
32
33 /* to make sure we are talking the same size under all OS's     */
34 typedef unsigned char sigBYTE;
35 typedef unsigned short sigWORD;
36 #if (defined(_MULTI_DATAMODEL) && defined(sun) && !defined(_ILP32))
37 typedef uint32_t sigLONG;
38 #else
39 typedef unsigned long sigLONG;
40 #endif
41
42 /*
43  * use sigWORDLittleEndian for:
44  *  dsCapabilities
45  *  dsDeviceSupp
46  *  dsAdapterSupp
47  *  dsApplication
48  * use sigLONGLittleEndian for:
49  *      dsOS
50  * so that the sig can be standardised to Little Endian
51  */
52 #if (defined(_DPT_BIG_ENDIAN))
53 # define sigWORDLittleEndian(x) ((((x)&0xFF)<<8)|(((x)>>8)&0xFF))
54 # define sigLONGLittleEndian(x) \
55         ((((x)&0xFF)<<24) |             \
56          (((x)&0xFF00)<<8) |    \
57          (((x)&0xFF0000L)>>8) | \
58          (((x)&0xFF000000L)>>24))
59 #else
60 # define sigWORDLittleEndian(x) (x)
61 # define sigLONGLittleEndian(x) (x)
62 #endif
63
64 /* must make sure the structure is not word or double-word aligned      */
65 /* ---------------------------------------------------------------      */
66 /* Borland will ignore the following pragma:                            */
67 /* Word alignment is OFF by default.  If in the, IDE make               */
68 /* sure that Options | Compiler | Code Generation | Word Alignment      */
69 /* is not checked.  If using BCC, do not use the -a option.             */
70
71 #ifndef NO_PACK
72 #if defined (_DPT_AIX)
73 #pragma options align=packed
74 #else
75 #pragma pack(1)
76 #endif  /* aix */
77 #endif
78 /* For the Macintosh */
79 #ifdef STRUCTALIGNMENTSUPPORTED
80 #pragma options align=mac68k
81 #endif
82
83
84 /* Current Signature Version - sigBYTE dsSigVersion; */
85 /* ------------------------------------------------------------------ */
86 #define SIG_VERSION 1
87
88 /* Processor Family - sigBYTE dsProcessorFamily;  DISTINCT VALUES */
89 /* ------------------------------------------------------------------ */
90 /* What type of processor the file is meant to run on. */
91 /* This will let us know whether to read sigWORDs as high/low or low/high. */
92 #define PROC_INTEL      0x00    /* Intel 80x86 */
93 #define PROC_MOTOROLA   0x01    /* Motorola 68K */
94 #define PROC_MIPS4000   0x02    /* MIPS RISC 4000 */
95 #define PROC_ALPHA      0x03    /* DEC Alpha */
96 #define PROC_POWERPC    0x04    /* IBM Power PC */
97 #define PROC_i960       0x05    /* Intel i960 */
98 #define PROC_ULTRASPARC 0x06    /* SPARC processor */
99
100 /* Specific Minimim Processor - sigBYTE dsProcessor;    FLAG BITS */
101 /* ------------------------------------------------------------------ */
102 /* Different bit definitions dependent on processor_family */
103
104 /* PROC_INTEL: */
105 #define PROC_8086       0x01    /* Intel 8086 */
106 #define PROC_286        0x02    /* Intel 80286 */
107 #define PROC_386        0x04    /* Intel 80386 */
108 #define PROC_486        0x08    /* Intel 80486 */
109 #define PROC_PENTIUM    0x10    /* Intel 586 aka P5 aka Pentium */
110 #define PROC_SEXIUM     0x20    /* Intel 686 aka P6 aka Pentium Pro or MMX */
111
112 /* PROC_i960: */
113 #define PROC_960RX      0x01    /* Intel 80960RC/RD */
114 #define PROC_960HX      0x02    /* Intel 80960HA/HD/HT */
115
116 /* PROC_MOTOROLA: */
117 #define PROC_68000      0x01    /* Motorola 68000 */
118 #define PROC_68010      0x02    /* Motorola 68010 */
119 #define PROC_68020      0x04    /* Motorola 68020 */
120 #define PROC_68030      0x08    /* Motorola 68030 */
121 #define PROC_68040      0x10    /* Motorola 68040 */
122
123 /* PROC_POWERPC */
124 #define PROC_PPC601             0x01    /* PowerPC 601 */
125 #define PROC_PPC603             0x02    /* PowerPC 603 */
126 #define PROC_PPC604             0x04    /* PowerPC 604 */
127
128 /* PROC_MIPS4000: */
129 #define PROC_R4000      0x01    /* MIPS R4000 */
130
131 /* Filetype - sigBYTE dsFiletype;       DISTINCT VALUES */
132 /* ------------------------------------------------------------------ */
133 #define FT_EXECUTABLE   0       /* Executable Program */
134 #define FT_SCRIPT       1       /* Script/Batch File??? */
135 #define FT_HBADRVR      2       /* HBA Driver */
136 #define FT_OTHERDRVR    3       /* Other Driver */
137 #define FT_IFS          4       /* Installable Filesystem Driver */
138 #define FT_ENGINE       5       /* DPT Engine */
139 #define FT_COMPDRVR     6       /* Compressed Driver Disk */
140 #define FT_LANGUAGE     7       /* Foreign Language file */
141 #define FT_FIRMWARE     8       /* Downloadable or actual Firmware */
142 #define FT_COMMMODL     9       /* Communications Module */
143 #define FT_INT13        10      /* INT 13 style HBA Driver */
144 #define FT_HELPFILE     11      /* Help file */
145 #define FT_LOGGER       12      /* Event Logger */
146 #define FT_INSTALL      13      /* An Install Program */
147 #define FT_LIBRARY      14      /* Storage Manager Real-Mode Calls */
148 #define FT_RESOURCE     15      /* Storage Manager Resource File */
149 #define FT_MODEM_DB     16      /* Storage Manager Modem Database */
150
151 /* Filetype flags - sigBYTE dsFiletypeFlags;    FLAG BITS */
152 /* ------------------------------------------------------------------ */
153 #define FTF_DLL         0x01    /* Dynamic Link Library */
154 #define FTF_NLM         0x02    /* Netware Loadable Module */
155 #define FTF_OVERLAYS    0x04    /* Uses overlays */
156 #define FTF_DEBUG       0x08    /* Debug version */
157 #define FTF_TSR         0x10    /* TSR */
158 #define FTF_SYS         0x20    /* DOS Loadable driver */
159 #define FTF_PROTECTED   0x40    /* Runs in protected mode */
160 #define FTF_APP_SPEC    0x80    /* Application Specific */
161 #define FTF_ROM         (FTF_SYS|FTF_TSR)       /* Special Case */
162
163 /* OEM - sigBYTE dsOEM;         DISTINCT VALUES */
164 /* ------------------------------------------------------------------ */
165 #define OEM_DPT         0       /* DPT */
166 #define OEM_ATT         1       /* ATT */
167 #define OEM_NEC         2       /* NEC */
168 #define OEM_ALPHA       3       /* Alphatronix */
169 #define OEM_AST         4       /* AST */
170 #define OEM_OLIVETTI    5       /* Olivetti */
171 #define OEM_SNI         6       /* Siemens/Nixdorf */
172 #define OEM_SUN         7       /* SUN Microsystems */
173
174 /* Operating System  - sigLONG dsOS;    FLAG BITS */
175 /* ------------------------------------------------------------------ */
176 #define OS_DOS          0x00000001 /* PC/MS-DOS                         */
177 #define OS_WINDOWS      0x00000002 /* Microsoft Windows 3.x             */
178 #define OS_WINDOWS_NT   0x00000004 /* Microsoft Windows NT              */
179 #define OS_OS2M         0x00000008 /* OS/2 1.2.x,MS 1.3.0,IBM 1.3.x - Monolithic */
180 #define OS_OS2L         0x00000010 /* Microsoft OS/2 1.301 - LADDR      */
181 #define OS_OS22x        0x00000020 /* IBM OS/2 2.x                      */
182 #define OS_NW286        0x00000040 /* Novell NetWare 286                */
183 #define OS_NW386        0x00000080 /* Novell NetWare 386                */
184 #define OS_GEN_UNIX     0x00000100 /* Generic Unix                      */
185 #define OS_SCO_UNIX     0x00000200 /* SCO Unix                          */
186 #define OS_ATT_UNIX     0x00000400 /* ATT Unix                          */
187 #define OS_UNIXWARE     0x00000800 /* USL Unix                          */
188 #define OS_INT_UNIX     0x00001000 /* Interactive Unix                  */
189 #define OS_SOLARIS      0x00002000 /* SunSoft Solaris                   */
190 #define OS_QNX          0x00004000 /* QNX for Tom Moch                  */
191 #define OS_NEXTSTEP     0x00008000 /* NeXTSTEP/OPENSTEP/MACH            */
192 #define OS_BANYAN       0x00010000 /* Banyan Vines                      */
193 #define OS_OLIVETTI_UNIX 0x00020000/* Olivetti Unix                     */
194 #define OS_MAC_OS       0x00040000 /* Mac OS                            */
195 #define OS_WINDOWS_95   0x00080000 /* Microsoft Windows '95             */
196 #define OS_NW4x         0x00100000 /* Novell Netware 4.x                */
197 #define OS_BSDI_UNIX    0x00200000 /* BSDi Unix BSD/OS 2.0 and up       */
198 #define OS_AIX_UNIX     0x00400000 /* AIX Unix                          */
199 #define OS_FREE_BSD     0x00800000 /* FreeBSD Unix                      */
200 #define OS_LINUX        0x01000000 /* Linux                             */
201 #define OS_DGUX_UNIX    0x02000000 /* Data General Unix                 */
202 #define OS_SINIX_N      0x04000000 /* SNI SINIX-N                       */
203 #define OS_PLAN9        0x08000000 /* ATT Plan 9                        */
204 #define OS_TSX          0x10000000 /* SNH TSX-32                        */
205
206 #define OS_OTHER        0x80000000 /* Other                             */
207
208 /* Capabilities - sigWORD dsCapabilities;        FLAG BITS */
209 /* ------------------------------------------------------------------ */
210 #define CAP_RAID0       0x0001  /* RAID-0 */
211 #define CAP_RAID1       0x0002  /* RAID-1 */
212 #define CAP_RAID3       0x0004  /* RAID-3 */
213 #define CAP_RAID5       0x0008  /* RAID-5 */
214 #define CAP_SPAN        0x0010  /* Spanning */
215 #define CAP_PASS        0x0020  /* Provides passthrough */
216 #define CAP_OVERLAP     0x0040  /* Passthrough supports overlapped commands */
217 #define CAP_ASPI        0x0080  /* Supports ASPI Command Requests */
218 #define CAP_ABOVE16MB   0x0100  /* ISA Driver supports greater than 16MB */
219 #define CAP_EXTEND      0x8000  /* Extended info appears after description */
220 #ifdef SNI_MIPS
221 #define CAP_CACHEMODE   0x1000  /* dpt_force_cache is set in driver */
222 #endif
223
224 /* Devices Supported - sigWORD dsDeviceSupp;    FLAG BITS */
225 /* ------------------------------------------------------------------ */
226 #define DEV_DASD        0x0001  /* DASD (hard drives) */
227 #define DEV_TAPE        0x0002  /* Tape drives */
228 #define DEV_PRINTER     0x0004  /* Printers */
229 #define DEV_PROC        0x0008  /* Processors */
230 #define DEV_WORM        0x0010  /* WORM drives */
231 #define DEV_CDROM       0x0020  /* CD-ROM drives */
232 #define DEV_SCANNER     0x0040  /* Scanners */
233 #define DEV_OPTICAL     0x0080  /* Optical Drives */
234 #define DEV_JUKEBOX     0x0100  /* Jukebox */
235 #define DEV_COMM        0x0200  /* Communications Devices */
236 #define DEV_OTHER       0x0400  /* Other Devices */
237 #define DEV_ALL         0xFFFF  /* All SCSI Devices */
238
239 /* Adapters Families Supported - sigWORD dsAdapterSupp; FLAG BITS */
240 /* ------------------------------------------------------------------ */
241 #define ADF_2001        0x0001  /* PM2001           */
242 #define ADF_2012A       0x0002  /* PM2012A          */
243 #define ADF_PLUS_ISA    0x0004  /* PM2011,PM2021    */
244 #define ADF_PLUS_EISA   0x0008  /* PM2012B,PM2022   */
245 #define ADF_SC3_ISA     0x0010  /* PM2021           */
246 #define ADF_SC3_EISA    0x0020  /* PM2022,PM2122, etc */
247 #define ADF_SC3_PCI     0x0040  /* SmartCache III PCI */
248 #define ADF_SC4_ISA     0x0080  /* SmartCache IV ISA */
249 #define ADF_SC4_EISA    0x0100  /* SmartCache IV EISA */
250 #define ADF_SC4_PCI     0x0200  /* SmartCache IV PCI */
251 #define ADF_SC5_PCI     0x0400  /* Fifth Generation I2O products */
252 /*
253  *      Combinations of products
254  */
255 #define ADF_ALL_2000    (ADF_2001|ADF_2012A)
256 #define ADF_ALL_PLUS    (ADF_PLUS_ISA|ADF_PLUS_EISA)
257 #define ADF_ALL_SC3     (ADF_SC3_ISA|ADF_SC3_EISA|ADF_SC3_PCI)
258 #define ADF_ALL_SC4     (ADF_SC4_ISA|ADF_SC4_EISA|ADF_SC4_PCI)
259 #define ADF_ALL_SC5     (ADF_SC5_PCI)
260 /* All EATA Cacheing Products */
261 #define ADF_ALL_CACHE   (ADF_ALL_PLUS|ADF_ALL_SC3|ADF_ALL_SC4)
262 /* All EATA Bus Mastering Products */
263 #define ADF_ALL_MASTER  (ADF_2012A|ADF_ALL_CACHE)
264 /* All EATA Adapter Products */
265 #define ADF_ALL_EATA    (ADF_2001|ADF_ALL_MASTER)
266 #define ADF_ALL         ADF_ALL_EATA
267
268 /* Application - sigWORD dsApplication;         FLAG BITS */
269 /* ------------------------------------------------------------------ */
270 #define APP_DPTMGR      0x0001  /* DPT Storage Manager */
271 #define APP_ENGINE      0x0002  /* DPT Engine */
272 #define APP_SYTOS       0x0004  /* Sytron Sytos Plus */
273 #define APP_CHEYENNE    0x0008  /* Cheyenne ARCServe + ARCSolo */
274 #define APP_MSCDEX      0x0010  /* Microsoft CD-ROM extensions */
275 #define APP_NOVABACK    0x0020  /* NovaStor Novaback */
276 #define APP_AIM         0x0040  /* Archive Information Manager */
277
278 /* Requirements - sigBYTE dsRequirements;         FLAG BITS             */
279 /* ------------------------------------------------------------------   */
280 #define REQ_SMARTROM    0x01    /* Requires SmartROM to be present      */
281 #define REQ_DPTDDL      0x02    /* Requires DPTDDL.SYS to be loaded     */
282 #define REQ_HBA_DRIVER  0x04    /* Requires an HBA driver to be loaded  */
283 #define REQ_ASPI_TRAN   0x08    /* Requires an ASPI Transport Modules   */
284 #define REQ_ENGINE      0x10    /* Requires a DPT Engine to be loaded   */
285 #define REQ_COMM_ENG    0x20    /* Requires a DPT Communications Engine */
286
287 /*
288  * You may adjust dsDescription_size with an override to a value less than
289  * 50 so that the structure allocates less real space.
290  */
291 #if (!defined(dsDescription_size))
292 # define dsDescription_size 50
293 #endif
294
295 typedef struct dpt_sig {
296     char    dsSignature[6];      /* ALWAYS "dPtSiG" */
297     sigBYTE dsSigVersion;        /* signature version (currently 1) */
298     sigBYTE dsProcessorFamily;   /* what type of processor */
299     sigBYTE dsProcessor;         /* precise processor */
300     sigBYTE dsFiletype;          /* type of file */
301     sigBYTE dsFiletypeFlags;     /* flags to specify load type, etc. */
302     sigBYTE dsOEM;               /* OEM file was created for */
303     sigLONG dsOS;                /* which Operating systems */
304     sigWORD dsCapabilities;      /* RAID levels, etc. */
305     sigWORD dsDeviceSupp;        /* Types of SCSI devices supported */
306     sigWORD dsAdapterSupp;       /* DPT adapter families supported */
307     sigWORD dsApplication;       /* applications file is for */
308     sigBYTE dsRequirements;      /* Other driver dependencies */
309     sigBYTE dsVersion;           /* 1 */
310     sigBYTE dsRevision;          /* 'J' */
311     sigBYTE dsSubRevision;       /* '9'   ' ' if N/A */
312     sigBYTE dsMonth;             /* creation month */
313     sigBYTE dsDay;               /* creation day */
314     sigBYTE dsYear;              /* creation year since 1980 (1993=13) */
315     /* description (NULL terminated) */
316     char  dsDescription[dsDescription_size];
317 } dpt_sig_S;
318 /* 32 bytes minimum - with no description.  Put NULL at description[0] */
319 /* 81 bytes maximum - with 49 character description plus NULL. */
320
321 /* This line added at Roycroft's request */
322 /* Microsoft's NT compiler gets confused if you do a pack and don't */
323 /* restore it. */
324
325 #ifndef NO_UNPACK
326 #if defined (_DPT_AIX)
327 #pragma options align=reset
328 #elif defined (UNPACK_FOUR)
329 #pragma pack(4)
330 #else
331 #pragma pack()
332 #endif  /* aix */
333 #endif
334 /* For the Macintosh */
335 #ifdef STRUCTALIGNMENTSUPPORTED
336 #pragma options align=reset
337 #endif
338
339 #endif