include/peexe.h

   1 /*
   2  * Copyright  Eric Youngdale (1994)
   3  */
   4 #ifndef __WINE_PEEXE_H
   5 #define __WINE_PEEXE_H
   6
   7 #include "wintypes.h"
   8 #include "neexe.h"
   9
  10 typedef struct _IMAGE_FILE_HEADER {
  11         WORD    Machine;                        /* 00 */
  12         WORD    NumberOfSections;               /* 02 */
  13         DWORD   TimeDateStamp;                  /* 04 */
  14         DWORD   PointerToSymbolTable;           /* 08 */
  15         DWORD   NumberOfSymbols;                /* 0c */
  16         WORD    SizeOfOptionalHeader;           /* 10 */
  17         WORD    Characteristics;                /* 12 */
  18 } IMAGE_FILE_HEADER,*LPIMAGE_FILE_HEADER;
  19
  20 #define IMAGE_SIZEOF_FILE_HEADER        20
  21
  22 /* These defines describe the meanings of the bits in the Characteristics
  23    field */
  24
  25 #define IMAGE_FILE_RELOCS_STRIPPED      1 /* No relocation info */
  26 #define IMAGE_FILE_EXECUTABLE_IMAGE     2
  27 #define IMAGE_FILE_LINE_NUMS_STRIPPED   4
  28 #define IMAGE_FILE_LOCAL_SYMS_STRIPPED  8
  29 #define IMAGE_FILE_16BIT_MACHINE        0x40
  30 #define IMAGE_FILE_BYTES_REVERSED_LO    0x80
  31 #define IMAGE_FILE_32BIT_MACHINE        0x100
  32 #define IMAGE_FILE_DEBUG_STRIPPED       0x200
  33 #define IMAGE_FILE_SYSTEM               0x1000
  34 #define IMAGE_FILE_DLL                  0x2000
  35 #define IMAGE_FILE_BYTES_REVERSED_HI    0x8000
  36
  37 /* These are the settings of the Machine field. */
  38 #define IMAGE_FILE_MACHINE_UNKNOWN      0
  39 #define IMAGE_FILE_MACHINE_I860         0x14d
  40 #define IMAGE_FILE_MACHINE_I386         0x14c
  41 #define IMAGE_FILE_MACHINE_R3000        0x162
  42 #define IMAGE_FILE_MACHINE_R4000        0x166
  43 #define IMAGE_FILE_MACHINE_R10000       0x168
  44 #define IMAGE_FILE_MACHINE_ALPHA        0x184
  45 #define IMAGE_FILE_MACHINE_POWERPC      0x1F0
  46
  47 typedef struct _IMAGE_DATA_DIRECTORY
  48 {
  49         DWORD   VirtualAddress;
  50         DWORD   Size;
  51 } IMAGE_DATA_DIRECTORY,*LPIMAGE_DATA_DIRECTORY;
  52
  53 #define IMAGE_NUMBEROF_DIRECTORY_ENTRIES 16
  54
  55 /* Optional coff header - used by NT to provide additional information. */
  56 typedef struct _IMAGE_OPTIONAL_HEADER
  57 {
  58         /*
  59          * Standard fields.
  60          */
  61
  62         WORD    Magic;                          /* 00 */
  63         BYTE    MajorLinkerVersion;             /* 02 */
  64         BYTE    MinorLinkerVersion;             /* 03 */
  65         DWORD   SizeOfCode;                     /* 04 */
  66         DWORD   SizeOfInitializedData;          /* 08 */
  67         DWORD   SizeOfUninitializedData;        /* 0C */
  68         DWORD   AddressOfEntryPoint;            /* 10 */
  69         DWORD   BaseOfCode;                     /* 14 */
  70         DWORD   BaseOfData;                     /* 18 */
  71
  72         /*
  73          * NT additional fields.
  74          */
  75
  76         DWORD   ImageBase;                      /* 1C */
  77         DWORD   SectionAlignment;               /* 20 */
  78         DWORD   FileAlignment;                  /* 24 */
  79         WORD    MajorOperatingSystemVersion;    /* 28 */
  80         WORD    MinorOperatingSystemVersion;    /* 2A */
  81         WORD    MajorImageVersion;              /* 2C */
  82         WORD    MinorImageVersion;              /* 2E */
  83         WORD    MajorSubsystemVersion;          /* 30 */
  84         WORD    MinorSubsystemVersion;          /* 32 */
  85         DWORD   Reserved1;                      /* 34 */
  86         DWORD   SizeOfImage;                    /* 38 */
  87         DWORD   SizeOfHeaders;                  /* 3C */
  88         DWORD   CheckSum;                       /* 40 */
  89         WORD    Subsystem;                      /* 44 */
  90         WORD    DllCharacteristics;             /* 46 */
  91         DWORD   SizeOfStackReserve;             /* 48 */
  92         DWORD   SizeOfStackCommit;              /* 4C */
  93         DWORD   SizeOfHeapReserve;              /* 50 */
  94         DWORD   SizeOfHeapCommit;               /* 54 */
  95         DWORD   LoaderFlags;                    /* 58 */
  96         DWORD   NumberOfRvaAndSizes;            /* 5C */
  97                                                 /* 60: */
  98         IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES];
  99 } IMAGE_OPTIONAL_HEADER,*LPIMAGE_OPTIONAL_HEADER;
 100
 101 /* Possible Magic values */
 102 #define IMAGE_NT_OPTIONAL_HDR_MAGIC        0x10b
 103 #define IMAGE_ROM_OPTIONAL_HDR_MAGIC       0x107
 104
 105 /* These are indexes into the DataDirectory array */
 106 #define IMAGE_FILE_EXPORT_DIRECTORY             0
 107 #define IMAGE_FILE_IMPORT_DIRECTORY             1
 108 #define IMAGE_FILE_RESOURCE_DIRECTORY           2
 109 #define IMAGE_FILE_EXCEPTION_DIRECTORY          3
 110 #define IMAGE_FILE_SECURITY_DIRECTORY           4
 111 #define IMAGE_FILE_BASE_RELOCATION_TABLE        5
 112 #define IMAGE_FILE_DEBUG_DIRECTORY              6
 113 #define IMAGE_FILE_DESCRIPTION_STRING           7
 114 #define IMAGE_FILE_MACHINE_VALUE                8  /* Mips */
 115 #define IMAGE_FILE_THREAD_LOCAL_STORAGE         9
 116 #define IMAGE_FILE_CALLBACK_DIRECTORY           10
 117
 118 /* Directory Entries, indices into the DataDirectory array */
 119
 120 #define IMAGE_DIRECTORY_ENTRY_EXPORT            0
 121 #define IMAGE_DIRECTORY_ENTRY_IMPORT            1
 122 #define IMAGE_DIRECTORY_ENTRY_RESOURCE          2
 123 #define IMAGE_DIRECTORY_ENTRY_EXCEPTION         3
 124 #define IMAGE_DIRECTORY_ENTRY_SECURITY          4
 125 #define IMAGE_DIRECTORY_ENTRY_BASERELOC         5
 126 #define IMAGE_DIRECTORY_ENTRY_DEBUG             6
 127 #define IMAGE_DIRECTORY_ENTRY_COPYRIGHT         7
 128 #define IMAGE_DIRECTORY_ENTRY_GLOBALPTR         8   /* (MIPS GP) */
 129 #define IMAGE_DIRECTORY_ENTRY_TLS               9
 130 #define IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG       10
 131 #define IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT      11
 132 #define IMAGE_DIRECTORY_ENTRY_IAT               12  /* Import Address Table */
 133
 134 /* Subsystem Values */
 135
 136 #define IMAGE_SUBSYSTEM_UNKNOWN         0
 137 #define IMAGE_SUBSYSTEM_NATIVE          1
 138 #define IMAGE_SUBSYSTEM_WINDOWS_GUI     2       /* Windows GUI subsystem */
 139 #define IMAGE_SUBSYSTEM_WINDOWS_CUI     3       /* Windows character subsystem*/
 140 #define IMAGE_SUBSYSTEM_OS2_CUI         5
 141 #define IMAGE_SUBSYSTEM_POSIX_CUI       7
 142
 143 typedef struct _IMAGE_NT_HEADERS {
 144         DWORD                   Signature;      /* 00: PE\0\0 */
 145         IMAGE_FILE_HEADER       FileHeader;     /* 04: Fileheader */
 146         IMAGE_OPTIONAL_HEADER   OptionalHeader; /* 18: Optional Header */
 147 } IMAGE_NT_HEADERS,*LPIMAGE_NT_HEADERS;
 148
 149
 150 #define PE_HEADER(module) \
 151     ((IMAGE_NT_HEADERS*)((LPBYTE)(module) + \
 152                          (((IMAGE_DOS_HEADER*)(module))->e_lfanew)))
 153
 154 #define PE_SECTIONS(module) \
 155     ((IMAGE_SECTION_HEADER*)((LPBYTE)&PE_HEADER(module)->OptionalHeader + \
 156                            PE_HEADER(module)->FileHeader.SizeOfOptionalHeader))
 157
 158 #define RVA_PTR(module,field) ((LPBYTE)(module) + PE_HEADER(module)->field)
 159
 160 /* Section header format */
 161
 162 #define IMAGE_SIZEOF_SHORT_NAME 8
 163
 164 typedef struct _IMAGE_SECTION_HEADER {
 165         BYTE    Name[IMAGE_SIZEOF_SHORT_NAME];  /* 00: */
 166         union {
 167                 DWORD   PhysicalAddress;        /* 04: */
 168                 DWORD   VirtualSize;            /* 04: */
 169         } Misc;
 170         DWORD   VirtualAddress;                 /* 08: */
 171         DWORD   SizeOfRawData;                  /* 0C: */
 172         DWORD   PointerToRawData;               /* 10: */
 173         DWORD   PointerToRelocations;           /* 14: */
 174         DWORD   PointerToLinenumbers;           /* 18: */
 175         WORD    NumberOfRelocations;            /* 1C: */
 176         WORD    NumberOfLinenumbers;            /* 1E: */
 177         DWORD   Characteristics;                /* 20: */
 178                                                 /* 24: */
 179 } IMAGE_SECTION_HEADER,*LPIMAGE_SECTION_HEADER;
 180
 181 #define IMAGE_SIZEOF_SECTION_HEADER 40
 182
 183 /* These defines are for the Characteristics bitfield. */
 184 /* #define IMAGE_SCN_TYPE_REG                   0x00000000 - Reserved */
 185 /* #define IMAGE_SCN_TYPE_DSECT                 0x00000001 - Reserved */
 186 /* #define IMAGE_SCN_TYPE_NOLOAD                0x00000002 - Reserved */
 187 /* #define IMAGE_SCN_TYPE_GROUP                 0x00000004 - Reserved */
 188 /* #define IMAGE_SCN_TYPE_NO_PAD                0x00000008 - Reserved */
 189 /* #define IMAGE_SCN_TYPE_COPY                  0x00000010 - Reserved */
 190
 191 #define IMAGE_SCN_CNT_CODE                      0x00000020
 192 #define IMAGE_SCN_CNT_INITIALIZED_DATA          0x00000040
 193 #define IMAGE_SCN_CNT_UNINITIALIZED_DATA        0x00000080
 194
 195 #define IMAGE_SCN_LNK_OTHER                     0x00000100
 196 #define IMAGE_SCN_LNK_INFO                      0x00000200
 197 /* #define      IMAGE_SCN_TYPE_OVER             0x00000400 - Reserved */
 198 #define IMAGE_SCN_LNK_REMOVE                    0x00000800
 199 #define IMAGE_SCN_LNK_COMDAT                    0x00001000
 200
 201 /*                                              0x00002000 - Reserved */
 202 /* #define IMAGE_SCN_MEM_PROTECTED              0x00004000 - Obsolete */
 203 #define IMAGE_SCN_MEM_FARDATA                   0x00008000
 204
 205 /* #define IMAGE_SCN_MEM_SYSHEAP                0x00010000 - Obsolete */
 206 #define IMAGE_SCN_MEM_PURGEABLE                 0x00020000
 207 #define IMAGE_SCN_MEM_16BIT                     0x00020000
 208 #define IMAGE_SCN_MEM_LOCKED                    0x00040000
 209 #define IMAGE_SCN_MEM_PRELOAD                   0x00080000
 210
 211 #define IMAGE_SCN_ALIGN_1BYTES                  0x00100000
 212 #define IMAGE_SCN_ALIGN_2BYTES                  0x00200000
 213 #define IMAGE_SCN_ALIGN_4BYTES                  0x00300000
 214 #define IMAGE_SCN_ALIGN_8BYTES                  0x00400000
 215 #define IMAGE_SCN_ALIGN_16BYTES                 0x00500000  /* Default */
 216 #define IMAGE_SCN_ALIGN_32BYTES                 0x00600000
 217 #define IMAGE_SCN_ALIGN_64BYTES                 0x00700000
 218 /*                                              0x00800000 - Unused */
 219
 220 #define IMAGE_SCN_LNK_NRELOC_OVFL               0x01000000
 221
 222
 223 #define IMAGE_SCN_MEM_DISCARDABLE               0x02000000
 224 #define IMAGE_SCN_MEM_NOT_CACHED                0x04000000
 225 #define IMAGE_SCN_MEM_NOT_PAGED                 0x08000000
 226 #define IMAGE_SCN_MEM_SHARED                    0x10000000
 227 #define IMAGE_SCN_MEM_EXECUTE                   0x20000000
 228 #define IMAGE_SCN_MEM_READ                      0x40000000
 229 #define IMAGE_SCN_MEM_WRITE                     0x80000000
 230
 231
 232 /* Import name entry */
 233 typedef struct _IMAGE_IMPORT_BY_NAME {
 234         WORD    Hint;
 235         BYTE    Name[1];
 236 } IMAGE_IMPORT_BY_NAME,*LPIMAGE_IMPORT_BY_NAME;
 237
 238 /* Import thunk */
 239 typedef struct _IMAGE_THUNK_DATA {
 240         union {
 241                 LPBYTE  ForwarderString;
 242                 LPDWORD Function;
 243                 DWORD   Ordinal;
 244                 LPIMAGE_IMPORT_BY_NAME  AddressOfData;
 245         } u1;
 246 } IMAGE_THUNK_DATA,*LPIMAGE_THUNK_DATA;
 247
 248 /* Import module directory */
 249
 250 typedef struct _IMAGE_IMPORT_DESCRIPTOR {
 251         union {
 252                 DWORD   Characteristics; /* 0 for terminating null import descriptor  */
 253                 LPIMAGE_THUNK_DATA OriginalFirstThunk;  /* RVA to original unbound IAT */
 254         } u;
 255         DWORD   TimeDateStamp;  /* 0 if not bound,
 256                                  * -1 if bound, and real date\time stamp
 257                                  *    in IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT
 258                                  * (new BIND)
 259                                  * otherwise date/time stamp of DLL bound to
 260                                  * (Old BIND)
 261                                  */
 262         DWORD   ForwarderChain; /* -1 if no forwarders */
 263         DWORD   Name;
 264         /* RVA to IAT (if bound this IAT has actual addresses) */
 265         LPIMAGE_THUNK_DATA FirstThunk;
 266 } IMAGE_IMPORT_DESCRIPTOR,*LPIMAGE_IMPORT_DESCRIPTOR;
 267
 268 #define IMAGE_ORDINAL_FLAG              0x80000000
 269 #define IMAGE_SNAP_BY_ORDINAL(Ordinal)  ((Ordinal & IMAGE_ORDINAL_FLAG) != 0)
 270 #define IMAGE_ORDINAL(Ordinal)          (Ordinal & 0xffff)
 271
 272 /* Export module directory */
 273
 274 typedef struct _IMAGE_EXPORT_DIRECTORY {
 275         DWORD   Characteristics;
 276         DWORD   TimeDateStamp;
 277         WORD    MajorVersion;
 278         WORD    MinorVersion;
 279         DWORD   Name;
 280         DWORD   Base;
 281         DWORD   NumberOfFunctions;
 282         DWORD   NumberOfNames;
 283         LPDWORD *AddressOfFunctions;
 284         LPDWORD *AddressOfNames;
 285         LPWORD  *AddressOfNameOrdinals;
 286 /*  u_char ModuleName[1]; */
 287 } IMAGE_EXPORT_DIRECTORY,*LPIMAGE_EXPORT_DIRECTORY;
 288
 289
 290 /*
 291  * Resource directory stuff
 292  */
 293 typedef struct _IMAGE_RESOURCE_DIRECTORY {
 294         DWORD   Characteristics;
 295         DWORD   TimeDateStamp;
 296         WORD    MajorVersion;
 297         WORD    MinorVersion;
 298         WORD    NumberOfNamedEntries;
 299         WORD    NumberOfIdEntries;
 300         /*  IMAGE_RESOURCE_DIRECTORY_ENTRY DirectoryEntries[]; */
 301 } IMAGE_RESOURCE_DIRECTORY,*LPIMAGE_RESOURCE_DIRECTORY;
 302
 303 #define IMAGE_RESOURCE_NAME_IS_STRING           0x80000000
 304 #define IMAGE_RESOURCE_DATA_IS_DIRECTORY        0x80000000
 305
 306 typedef struct _IMAGE_RESOURCE_DIRECTORY_ENTRY {
 307         union {
 308                 struct {
 309                         DWORD NameOffset:31;
 310                         DWORD NameIsString:1;
 311                 } s;
 312                 DWORD   Name;
 313                 WORD    Id;
 314         } u1;
 315         union {
 316                 DWORD   OffsetToData;
 317                 struct {
 318                         DWORD   OffsetToDirectory:31;
 319                         DWORD   DataIsDirectory:1;
 320                 } s;
 321         } u2;
 322 } IMAGE_RESOURCE_DIRECTORY_ENTRY,*LPIMAGE_RESOURCE_DIRECTORY_ENTRY;
 323
 324
 325 typedef struct _IMAGE_RESOURCE_DIRECTORY_STRING {
 326         WORD    Length;
 327         CHAR    NameString[ 1 ];
 328 } IMAGE_RESOURCE_DIRECTORY_STRING,*LPIMAGE_RESOURCE_DIRECTORY_STRING;
 329
 330 typedef struct _IMAGE_RESOURCE_DIR_STRING_U {
 331         WORD    Length;
 332         WCHAR   NameString[ 1 ];
 333 } IMAGE_RESOURCE_DIR_STRING_U,*LPIMAGE_RESOURCE_DIR_STRING_U;
 334
 335 typedef struct _IMAGE_RESOURCE_DATA_ENTRY {
 336         DWORD   OffsetToData;
 337         DWORD   Size;
 338         DWORD   CodePage;
 339         DWORD   ResourceHandle;
 340 } IMAGE_RESOURCE_DATA_ENTRY,*LPIMAGE_RESOURCE_DATA_ENTRY;
 341
 342 typedef struct _IMAGE_BASE_RELOCATION
 343 {
 344         DWORD   VirtualAddress;
 345         DWORD   SizeOfBlock;
 346         WORD    TypeOffset[1];
 347 } IMAGE_BASE_RELOCATION,*LPIMAGE_BASE_RELOCATION;
 348
 349 typedef struct _IMAGE_LOAD_CONFIG_DIRECTORY {
 350         DWORD   Characteristics;
 351         DWORD   TimeDateStamp;
 352         WORD    MajorVersion;
 353         WORD    MinorVersion;
 354         DWORD   GlobalFlagsClear;
 355         DWORD   GlobalFlagsSet;
 356         DWORD   CriticalSectionDefaultTimeout;
 357         DWORD   DeCommitFreeBlockThreshold;
 358         DWORD   DeCommitTotalFreeThreshold;
 359         LPVOID  LockPrefixTable;
 360         DWORD   MaximumAllocationSize;
 361         DWORD   VirtualMemoryThreshold;
 362         DWORD   ProcessHeapFlags;
 363         DWORD   Reserved[ 4 ];
 364 } IMAGE_LOAD_CONFIG_DIRECTORY,*LPIMAGE_LOAD_CONFIG_DIRECTORY;
 365
 366 typedef VOID (CALLBACK *LPIMAGE_TLS_CALLBACK)(
 367         LPVOID DllHandle,DWORD Reason,LPVOID Reserved
 368 );
 369
 370 typedef struct _IMAGE_TLS_DIRECTORY {
 371         DWORD   StartAddressOfRawData;
 372         DWORD   EndAddressOfRawData;
 373         LPDWORD AddressOfIndex;
 374         LPIMAGE_TLS_CALLBACK *AddressOfCallBacks;
 375         DWORD   SizeOfZeroFill;
 376         DWORD   Characteristics;
 377 } IMAGE_TLS_DIRECTORY,*LPIMAGE_TLS_DIRECTORY;
 378
 379 /*
 380  * The IMAGE_DEBUG_DIRECTORY data directory points to an array of
 381  * these structures.
 382  */
 383 typedef struct _IMAGE_DEBUG_DIRECTORY {
 384         DWORD   Characteristics;
 385         DWORD   TimeDateStamp;
 386         WORD    MajorVersion;
 387         WORD    MinorVersion;
 388         DWORD   Type;
 389         DWORD   SizeOfData;
 390         DWORD   AddressOfRawData;
 391         DWORD   PointerToRawData;
 392 } IMAGE_DEBUG_DIRECTORY,*LPIMAGE_DEBUG_DIRECTORY;
 393
 394 /*
 395  * The type field above can take these (plus a few other
 396  * irrelevant) values.
 397  */
 398 #define IMAGE_DEBUG_TYPE_UNKNOWN        0
 399 #define IMAGE_DEBUG_TYPE_COFF           1
 400 #define IMAGE_DEBUG_TYPE_CODEVIEW       2
 401 #define IMAGE_DEBUG_TYPE_FPO            3
 402 #define IMAGE_DEBUG_TYPE_MISC           4
 403 #define IMAGE_DEBUG_TYPE_EXCEPTION      5
 404 #define IMAGE_DEBUG_TYPE_FIXUP          6
 405 #define IMAGE_DEBUG_TYPE_OMAP_TO_SRC    7
 406 #define IMAGE_DEBUG_TYPE_OMAP_FROM_SRC  8
 407
 408
 409 #define IMAGE_REL_BASED_ABSOLUTE                0
 410 #define IMAGE_REL_BASED_HIGH                    1
 411 #define IMAGE_REL_BASED_LOW                     2
 412 #define IMAGE_REL_BASED_HIGHLOW                 3
 413 #define IMAGE_REL_BASED_HIGHADJ                 4
 414 #define IMAGE_REL_BASED_MIPS_JMPADDR            5
 415
 416 /*
 417  * This is the structure that appears at the very start of a .DBG file.
 418  */
 419 typedef struct _IMAGE_SEPARATE_DEBUG_HEADER {
 420         WORD    Signature;
 421         WORD    Flags;
 422         WORD    Machine;
 423         WORD    Characteristics;
 424         DWORD   TimeDateStamp;
 425         DWORD   CheckSum;
 426         DWORD   ImageBase;
 427         DWORD   SizeOfImage;
 428         DWORD   NumberOfSections;
 429         DWORD   ExportedNamesSize;
 430         DWORD   DebugDirectorySize;
 431         DWORD   Reserved[ 3 ];
 432 } IMAGE_SEPARATE_DEBUG_HEADER,*LPIMAGE_SEPARATE_DEBUG_HEADER;
 433
 434 #define IMAGE_SEPARATE_DEBUG_SIGNATURE 0x4944
 435
 436 #endif /* __WINE_PEEXE_H */