1 /*      BSDI dptsig.h,v 1.7 1998/06/03 19:15:00 karels Exp      */
 
   4  * Copyright (c) 1996-1999 Distributed Processing Technology Corporation
 
   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.
 
  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.
 
  30 /* DPT SIGNATURE SPEC AND HEADER FILE                           */
 
  31 /* Signature Version 1 (sorry no 'A')                           */
 
  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;
 
  39 typedef unsigned long sigLONG;
 
  43  * use sigWORDLittleEndian for:
 
  48  * use sigLONGLittleEndian for:
 
  50  * so that the sig can be standardised to Little Endian
 
  52 #if (defined(_DPT_BIG_ENDIAN))
 
  53 # define sigWORDLittleEndian(x) ((((x)&0xFF)<<8)|(((x)>>8)&0xFF))
 
  54 # define sigLONGLittleEndian(x) \
 
  57          (((x)&0xFF0000L)>>8) | \
 
  58          (((x)&0xFF000000L)>>24))
 
  60 # define sigWORDLittleEndian(x) (x)
 
  61 # define sigLONGLittleEndian(x) (x)
 
  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.             */
 
  72 #if defined (_DPT_AIX)
 
  73 #pragma options align=packed
 
  78 /* For the Macintosh */
 
  79 #ifdef STRUCTALIGNMENTSUPPORTED
 
  80 #pragma options align=mac68k
 
  84 /* Current Signature Version - sigBYTE dsSigVersion; */
 
  85 /* ------------------------------------------------------------------ */
 
  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 */
 
 100 /* Specific Minimim Processor - sigBYTE dsProcessor;    FLAG BITS */
 
 101 /* ------------------------------------------------------------------ */
 
 102 /* Different bit definitions dependent on processor_family */
 
 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 */
 
 113 #define PROC_960RX      0x01    /* Intel 80960RC/RD */
 
 114 #define PROC_960HX      0x02    /* Intel 80960HA/HD/HT */
 
 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 */
 
 124 #define PROC_PPC601             0x01    /* PowerPC 601 */
 
 125 #define PROC_PPC603             0x02    /* PowerPC 603 */
 
 126 #define PROC_PPC604             0x04    /* PowerPC 604 */
 
 129 #define PROC_R4000      0x01    /* MIPS R4000 */
 
 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 */
 
 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 */
 
 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 */
 
 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                        */
 
 206 #define OS_OTHER        0x80000000 /* Other                             */
 
 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 */
 
 221 #define CAP_CACHEMODE   0x1000  /* dpt_force_cache is set in driver */
 
 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 */
 
 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 */
 
 253  *      Combinations of products
 
 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
 
 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 */
 
 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 */
 
 288  * You may adjust dsDescription_size with an override to a value less than
 
 289  * 50 so that the structure allocates less real space.
 
 291 #if (!defined(dsDescription_size))
 
 292 # define dsDescription_size 50
 
 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];
 
 318 /* 32 bytes minimum - with no description.  Put NULL at description[0] */
 
 319 /* 81 bytes maximum - with 49 character description plus NULL. */
 
 321 /* This line added at Roycroft's request */
 
 322 /* Microsoft's NT compiler gets confused if you do a pack and don't */
 
 326 #if defined (_DPT_AIX)
 
 327 #pragma options align=reset
 
 328 #elif defined (UNPACK_FOUR)
 
 334 /* For the Macintosh */
 
 335 #ifdef STRUCTALIGNMENTSUPPORTED
 
 336 #pragma options align=reset