VirtualBox

source: kBuild/trunk/src/lib/k/kLdrFmts/pe.h@ 2439

Last change on this file since 2439 was 2268, checked in by bird, 16 years ago

Import kLdrFmts/pe.h from kStuff.
  • Property svn:eol-style set to native
File size: 14.5 KB
Line 
1/* $Id: pe.h 2 2007-11-16 16:07:14Z bird $ */
2/** @file
3 * PE structures, types and defines.
4 */
5
6#ifndef ___k_kLdrFmts_pe_h___
7#define ___k_kLdrFmts_pe_h___
8
9
10/*******************************************************************************
11* Header Files *
12*******************************************************************************/
13#include <k/kTypes.h>
14#include <k/kDefs.h>
15
16
17/*******************************************************************************
18* Defined Constants And Macros *
19*******************************************************************************/
20#ifndef IMAGE_NT_SIGNATURE
21# define IMAGE_NT_SIGNATURE K_LE2H_U32('P' | ('E' << 8))
22#endif
23
24/* file header */
25#define IMAGE_FILE_MACHINE_I386 0x014c
26#define IMAGE_FILE_MACHINE_AMD64 0x8664
27
28#define IMAGE_FILE_RELOCS_STRIPPED 0x0001
29#define IMAGE_FILE_EXECUTABLE_IMAGE 0x0002
30#define IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004
31#define IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008
32#define IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010
33#define IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020
34#define IMAGE_FILE_16BIT_MACHINE 0x0040
35#define IMAGE_FILE_BYTES_REVERSED_LO 0x0080
36#define IMAGE_FILE_32BIT_MACHINE 0x0100
37#define IMAGE_FILE_DEBUG_STRIPPED 0x0200
38#define IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400
39#define IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800
40#define IMAGE_FILE_SYSTEM 0x1000
41#define IMAGE_FILE_DLL 0x2000
42#define IMAGE_FILE_UP_SYSTEM_ONLY 0x4000
43#define IMAGE_FILE_BYTES_REVERSED_HI 0x8000
44
45
46/* optional header */
47#define IMAGE_NT_OPTIONAL_HDR32_MAGIC 0x10B
48#define IMAGE_NT_OPTIONAL_HDR64_MAGIC 0x20B
49
50#define IMAGE_SUBSYSTEM_UNKNOWN 0x0
51#define IMAGE_SUBSYSTEM_NATIVE 0x1
52#define IMAGE_SUBSYSTEM_WINDOWS_GUI 0x2
53#define IMAGE_SUBSYSTEM_WINDOWS_CUI 0x3
54#define IMAGE_SUBSYSTEM_OS2_GUI 0x4
55#define IMAGE_SUBSYSTEM_OS2_CUI 0x5
56#define IMAGE_SUBSYSTEM_POSIX_CUI 0x7
57
58#define IMAGE_LIBRARY_PROCESS_INIT 0x0001
59#define IMAGE_LIBRARY_PROCESS_TERM 0x0002
60#define IMAGE_LIBRARY_THREAD_INIT 0x0004
61#define IMAGE_LIBRARY_THREAD_TERM 0x0008
62#define IMAGE_DLLCHARACTERISTICS_NO_ISOLATION 0x0200
63#define IMAGE_DLLCHARACTERISTICS_NO_SEH 0x0400
64#define IMAGE_DLLCHARACTERISTICS_NO_BIND 0x0800
65#define IMAGE_DLLCHARACTERISTICS_WDM_DRIVER 0x2000
66#define IMAGE_DLLCHARACTERISTICS_TERMINAL_SERVER_AWARE 0x8000
67
68#define IMAGE_NUMBEROF_DIRECTORY_ENTRIES 0x10
69
70#define IMAGE_DIRECTORY_ENTRY_EXPORT 0x0
71#define IMAGE_DIRECTORY_ENTRY_IMPORT 0x1
72#define IMAGE_DIRECTORY_ENTRY_RESOURCE 0x2
73#define IMAGE_DIRECTORY_ENTRY_EXCEPTION 0x3
74#define IMAGE_DIRECTORY_ENTRY_SECURITY 0x4
75#define IMAGE_DIRECTORY_ENTRY_BASERELOC 0x5
76#define IMAGE_DIRECTORY_ENTRY_DEBUG 0x6
77#define IMAGE_DIRECTORY_ENTRY_ARCHITECTURE 0x7
78#define IMAGE_DIRECTORY_ENTRY_COPYRIGHT IMAGE_DIRECTORY_ENTRY_ARCHITECTURE
79#define IMAGE_DIRECTORY_ENTRY_GLOBALPTR 0x8
80#define IMAGE_DIRECTORY_ENTRY_TLS 0x9
81#define IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 0xa
82#define IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT 0xb
83#define IMAGE_DIRECTORY_ENTRY_IAT 0xc
84#define IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT 0xd
85#define IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR 0xe
86
87
88/* section header */
89#define IMAGE_SIZEOF_SHORT_NAME 0x8
90
91#define IMAGE_SCN_TYPE_REG 0x00000000
92#define IMAGE_SCN_TYPE_DSECT 0x00000001
93#define IMAGE_SCN_TYPE_NOLOAD 0x00000002
94#define IMAGE_SCN_TYPE_GROUP 0x00000004
95#define IMAGE_SCN_TYPE_NO_PAD 0x00000008
96#define IMAGE_SCN_TYPE_COPY 0x00000010
97
98#define IMAGE_SCN_CNT_CODE 0x00000020
99#define IMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040
100#define IMAGE_SCN_CNT_UNINITIALIZED_DATA 0x00000080
101
102#define IMAGE_SCN_LNK_OTHER 0x00000100
103#define IMAGE_SCN_LNK_INFO 0x00000200
104#define IMAGE_SCN_TYPE_OVER 0x00000400
105#define IMAGE_SCN_LNK_REMOVE 0x00000800
106#define IMAGE_SCN_LNK_COMDAT 0x00001000
107#define IMAGE_SCN_MEM_PROTECTED 0x00004000
108#define IMAGE_SCN_NO_DEFER_SPEC_EXC 0x00004000
109#define IMAGE_SCN_GPREL 0x00008000
110#define IMAGE_SCN_MEM_FARDATA 0x00008000
111#define IMAGE_SCN_MEM_SYSHEAP 0x00010000
112#define IMAGE_SCN_MEM_PURGEABLE 0x00020000
113#define IMAGE_SCN_MEM_16BIT 0x00020000
114#define IMAGE_SCN_MEM_LOCKED 0x00040000
115#define IMAGE_SCN_MEM_PRELOAD 0x00080000
116
117#define IMAGE_SCN_ALIGN_1BYTES 0x00100000
118#define IMAGE_SCN_ALIGN_2BYTES 0x00200000
119#define IMAGE_SCN_ALIGN_4BYTES 0x00300000
120#define IMAGE_SCN_ALIGN_8BYTES 0x00400000
121#define IMAGE_SCN_ALIGN_16BYTES 0x00500000
122#define IMAGE_SCN_ALIGN_32BYTES 0x00600000
123#define IMAGE_SCN_ALIGN_64BYTES 0x00700000
124#define IMAGE_SCN_ALIGN_128BYTES 0x00800000
125#define IMAGE_SCN_ALIGN_256BYTES 0x00900000
126#define IMAGE_SCN_ALIGN_512BYTES 0x00A00000
127#define IMAGE_SCN_ALIGN_1024BYTES 0x00B00000
128#define IMAGE_SCN_ALIGN_2048BYTES 0x00C00000
129#define IMAGE_SCN_ALIGN_4096BYTES 0x00D00000
130#define IMAGE_SCN_ALIGN_8192BYTES 0x00E00000
131#define IMAGE_SCN_ALIGN_MASK 0x00F00000
132
133#define IMAGE_SCN_LNK_NRELOC_OVFL 0x01000000
134#define IMAGE_SCN_MEM_DISCARDABLE 0x02000000
135#define IMAGE_SCN_MEM_NOT_CACHED 0x04000000
136#define IMAGE_SCN_MEM_NOT_PAGED 0x08000000
137#define IMAGE_SCN_MEM_SHARED 0x10000000
138#define IMAGE_SCN_MEM_EXECUTE 0x20000000
139#define IMAGE_SCN_MEM_READ 0x40000000
140#define IMAGE_SCN_MEM_WRITE 0x80000000
141
142
143/* relocations */
144#define IMAGE_REL_BASED_ABSOLUTE 0x0
145#define IMAGE_REL_BASED_HIGH 0x1
146#define IMAGE_REL_BASED_LOW 0x2
147#define IMAGE_REL_BASED_HIGHLOW 0x3
148#define IMAGE_REL_BASED_HIGHADJ 0x4
149#define IMAGE_REL_BASED_MIPS_JMPADDR 0x5
150#define IMAGE_REL_BASED_SECTION 0x6
151#define IMAGE_REL_BASED_REL32 0x7
152/*#define IMAGE_REL_BASED_RESERVED1 0x8 */
153#define IMAGE_REL_BASED_MIPS_JMPADDR16 0x9
154#define IMAGE_REL_BASED_IA64_IMM64 0x9
155#define IMAGE_REL_BASED_DIR64 0xa
156#define IMAGE_REL_BASED_HIGH3ADJ 0xb
157
158/* imports */
159#define IMAGE_ORDINAL_FLAG32 0x80000000
160#define IMAGE_ORDINAL32(ord) ((ord) & 0xffff)
161#define IMAGE_SNAP_BY_ORDINAL32(ord) (!!((ord) & IMAGE_ORDINAL_FLAG32))
162
163#define IMAGE_ORDINAL_FLAG64 0x8000000000000000ULL
164#define IMAGE_ORDINAL64(ord) ((ord) & 0xffff)
165#define IMAGE_SNAP_BY_ORDINAL64(ord) (!!((ord) & IMAGE_ORDINAL_FLAG64))
166
167
168/* dll/tls entry points argument */
169#define DLL_PROCESS_DETACH 0
170#define DLL_PROCESS_ATTACH 1
171#define DLL_THREAD_ATTACH 2
172#define DLL_THREAD_DETACH 3
173
174
175/*******************************************************************************
176* Structures and Typedefs *
177*******************************************************************************/
178#pragma pack(4)
179
180typedef struct _IMAGE_FILE_HEADER
181{
182 KU16 Machine;
183 KU16 NumberOfSections;
184 KU32 TimeDateStamp;
185 KU32 PointerToSymbolTable;
186 KU32 NumberOfSymbols;
187 KU16 SizeOfOptionalHeader;
188 KU16 Characteristics;
189} IMAGE_FILE_HEADER;
190typedef IMAGE_FILE_HEADER *PIMAGE_FILE_HEADER;
191
192
193typedef struct _IMAGE_DATA_DIRECTORY
194{
195 KU32 VirtualAddress;
196 KU32 Size;
197} IMAGE_DATA_DIRECTORY;
198typedef IMAGE_DATA_DIRECTORY *PIMAGE_DATA_DIRECTORY;
199
200
201typedef struct _IMAGE_OPTIONAL_HEADER32
202{
203 KU16 Magic;
204 KU8 MajorLinkerVersion;
205 KU8 MinorLinkerVersion;
206 KU32 SizeOfCode;
207 KU32 SizeOfInitializedData;
208 KU32 SizeOfUninitializedData;
209 KU32 AddressOfEntryPoint;
210 KU32 BaseOfCode;
211 KU32 BaseOfData;
212 KU32 ImageBase;
213 KU32 SectionAlignment;
214 KU32 FileAlignment;
215 KU16 MajorOperatingSystemVersion;
216 KU16 MinorOperatingSystemVersion;
217 KU16 MajorImageVersion;
218 KU16 MinorImageVersion;
219 KU16 MajorSubsystemVersion;
220 KU16 MinorSubsystemVersion;
221 KU32 Win32VersionValue;
222 KU32 SizeOfImage;
223 KU32 SizeOfHeaders;
224 KU32 CheckSum;
225 KU16 Subsystem;
226 KU16 DllCharacteristics;
227 KU32 SizeOfStackReserve;
228 KU32 SizeOfStackCommit;
229 KU32 SizeOfHeapReserve;
230 KU32 SizeOfHeapCommit;
231 KU32 LoaderFlags;
232 KU32 NumberOfRvaAndSizes;
233 IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES];
234} IMAGE_OPTIONAL_HEADER32;
235typedef IMAGE_OPTIONAL_HEADER32 *PIMAGE_OPTIONAL_HEADER32;
236
237typedef struct _IMAGE_OPTIONAL_HEADER64
238{
239 KU16 Magic;
240 KU8 MajorLinkerVersion;
241 KU8 MinorLinkerVersion;
242 KU32 SizeOfCode;
243 KU32 SizeOfInitializedData;
244 KU32 SizeOfUninitializedData;
245 KU32 AddressOfEntryPoint;
246 KU32 BaseOfCode;
247 KU64 ImageBase;
248 KU32 SectionAlignment;
249 KU32 FileAlignment;
250 KU16 MajorOperatingSystemVersion;
251 KU16 MinorOperatingSystemVersion;
252 KU16 MajorImageVersion;
253 KU16 MinorImageVersion;
254 KU16 MajorSubsystemVersion;
255 KU16 MinorSubsystemVersion;
256 KU32 Win32VersionValue;
257 KU32 SizeOfImage;
258 KU32 SizeOfHeaders;
259 KU32 CheckSum;
260 KU16 Subsystem;
261 KU16 DllCharacteristics;
262 KU64 SizeOfStackReserve;
263 KU64 SizeOfStackCommit;
264 KU64 SizeOfHeapReserve;
265 KU64 SizeOfHeapCommit;
266 KU32 LoaderFlags;
267 KU32 NumberOfRvaAndSizes;
268 IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES];
269} IMAGE_OPTIONAL_HEADER64;
270typedef IMAGE_OPTIONAL_HEADER64 *PIMAGE_OPTIONAL_HEADER64;
271
272
273typedef struct _IMAGE_NT_HEADERS
274{
275 KU32 Signature;
276 IMAGE_FILE_HEADER FileHeader;
277 IMAGE_OPTIONAL_HEADER32 OptionalHeader;
278} IMAGE_NT_HEADERS32;
279typedef IMAGE_NT_HEADERS32 *PIMAGE_NT_HEADERS32;
280
281typedef struct _IMAGE_NT_HEADERS64
282{
283 KU32 Signature;
284 IMAGE_FILE_HEADER FileHeader;
285 IMAGE_OPTIONAL_HEADER64 OptionalHeader;
286} IMAGE_NT_HEADERS64;
287typedef IMAGE_NT_HEADERS64 *PIMAGE_NT_HEADERS64;
288
289
290typedef struct _IMAGE_SECTION_HEADER
291{
292 KU8 Name[IMAGE_SIZEOF_SHORT_NAME];
293 union
294 {
295 KU32 PhysicalAddress;
296 KU32 VirtualSize;
297 } Misc;
298 KU32 VirtualAddress;
299 KU32 SizeOfRawData;
300 KU32 PointerToRawData;
301 KU32 PointerToRelocations;
302 KU32 PointerToLinenumbers;
303 KU16 NumberOfRelocations;
304 KU16 NumberOfLinenumbers;
305 KU32 Characteristics;
306} IMAGE_SECTION_HEADER;
307typedef IMAGE_SECTION_HEADER *PIMAGE_SECTION_HEADER;
308
309
310typedef struct _IMAGE_BASE_RELOCATION
311{
312 KU32 VirtualAddress;
313 KU32 SizeOfBlock;
314} IMAGE_BASE_RELOCATION;
315typedef IMAGE_BASE_RELOCATION *PIMAGE_BASE_RELOCATION;
316
317
318typedef struct _IMAGE_EXPORT_DIRECTORY
319{
320 KU32 Characteristics;
321 KU32 TimeDateStamp;
322 KU16 MajorVersion;
323 KU16 MinorVersion;
324 KU32 Name;
325 KU32 Base;
326 KU32 NumberOfFunctions;
327 KU32 NumberOfNames;
328 KU32 AddressOfFunctions;
329 KU32 AddressOfNames;
330 KU32 AddressOfNameOrdinals;
331} IMAGE_EXPORT_DIRECTORY, *PIMAGE_EXPORT_DIRECTORY;
332
333
334typedef struct _IMAGE_IMPORT_DESCRIPTOR
335{
336 union
337 {
338 KU32 Characteristics;
339 KU32 OriginalFirstThunk;
340 } u;
341 KU32 TimeDateStamp;
342 KU32 ForwarderChain;
343 KU32 Name;
344 KU32 FirstThunk;
345} IMAGE_IMPORT_DESCRIPTOR;
346typedef IMAGE_IMPORT_DESCRIPTOR *PIMAGE_IMPORT_DESCRIPTOR;
347
348
349typedef struct _IMAGE_IMPORT_BY_NAME
350{
351 KU16 Hint;
352 KU8 Name[1];
353} IMAGE_IMPORT_BY_NAME;
354typedef IMAGE_IMPORT_BY_NAME *PIMAGE_IMPORT_BY_NAME;
355
356
357/* The image_thunk_data32/64 structures are not very helpful except for getting RSI. keep them around till all the code has been converted. */
358typedef struct _IMAGE_THUNK_DATA64
359{
360 union
361 {
362 KU64 ForwarderString;
363 KU64 Function;
364 KU64 Ordinal;
365 KU64 AddressOfData;
366 } u1;
367} IMAGE_THUNK_DATA64;
368typedef IMAGE_THUNK_DATA64 *PIMAGE_THUNK_DATA64;
369
370typedef struct _IMAGE_THUNK_DATA32
371{
372 union
373 {
374 KU32 ForwarderString;
375 KU32 Function;
376 KU32 Ordinal;
377 KU32 AddressOfData;
378 } u1;
379} IMAGE_THUNK_DATA32;
380typedef IMAGE_THUNK_DATA32 *PIMAGE_THUNK_DATA32;
381
382
383typedef struct _IMAGE_LOAD_CONFIG_DIRECTORY32
384{
385 KU32 Size;
386 KU32 TimeDateStamp;
387 KU16 MajorVersion;
388 KU16 MinorVersion;
389 KU32 GlobalFlagsClear;
390 KU32 GlobalFlagsSet;
391 KU32 CriticalSectionDefaultTimeout;
392 KU32 DeCommitFreeBlockThreshold;
393 KU32 DeCommitTotalFreeThreshold;
394 KU32 LockPrefixTable;
395 KU32 MaximumAllocationSize;
396 KU32 VirtualMemoryThreshold;
397 KU32 ProcessHeapFlags;
398 KU32 ProcessAffinityMask;
399 KU16 CSDVersion;
400 KU16 Reserved1;
401 KU32 EditList;
402 KU32 SecurityCookie;
403 KU32 SEHandlerTable;
404 KU32 SEHandlerCount;
405} IMAGE_LOAD_CONFIG_DIRECTORY32;
406typedef IMAGE_LOAD_CONFIG_DIRECTORY32 PIMAGE_LOAD_CONFIG_DIRECTORY32;
407
408typedef struct _IMAGE_LOAD_CONFIG_DIRECTORY64
409{
410 KU32 Size;
411 KU32 TimeDateStamp;
412 KU16 MajorVersion;
413 KU16 MinorVersion;
414 KU32 GlobalFlagsClear;
415 KU32 GlobalFlagsSet;
416 KU32 CriticalSectionDefaultTimeout;
417 KU64 DeCommitFreeBlockThreshold;
418 KU64 DeCommitTotalFreeThreshold;
419 KU64 LockPrefixTable;
420 KU64 MaximumAllocationSize;
421 KU64 VirtualMemoryThreshold;
422 KU64 ProcessAffinityMask;
423 KU32 ProcessHeapFlags;
424 KU16 CSDVersion;
425 KU16 Reserved1;
426 KU64 EditList;
427 KU64 SecurityCookie;
428 KU64 SEHandlerTable;
429 KU64 SEHandlerCount;
430} IMAGE_LOAD_CONFIG_DIRECTORY64;
431typedef IMAGE_LOAD_CONFIG_DIRECTORY64 *PIMAGE_LOAD_CONFIG_DIRECTORY64;
432
433typedef struct _IMAGE_DEBUG_DIRECTORY
434{
435 KU32 Characteristics;
436 KU32 TimeDateStamp;
437 KU16 MajorVersion;
438 KU16 MinorVersion;
439 KU32 Type;
440 KU32 SizeOfData;
441 KU32 AddressOfRawData;
442 KU32 PointerToRawData;
443} IMAGE_DEBUG_DIRECTORY;
444typedef IMAGE_DEBUG_DIRECTORY *PIMAGE_DEBUG_DIRECTORY;
445
446#define IMAGE_DEBUG_TYPE_UNKNOWN 0
447#define IMAGE_DEBUG_TYPE_COFF 1
448#define IMAGE_DEBUG_TYPE_CODEVIEW 2 /* 4.0 */
449#define IMAGE_DEBUG_TYPE_FPO 3 /* FPO = frame pointer omission */
450#define IMAGE_DEBUG_TYPE_MISC 4
451#define IMAGE_DEBUG_TYPE_EXCEPTION 5
452#define IMAGE_DEBUG_TYPE_FIXUP 6
453#define IMAGE_DEBUG_TYPE_BORLAND 9
454
455typedef struct _IMAGE_TLS_DIRECTORY32
456{
457 KU32 StartAddressOfRawData;
458 KU32 EndAddressOfRawData;
459 KU32 AddressOfIndex;
460 KU32 AddressOfCallBacks;
461 KU32 SizeOfZeroFill;
462 KU32 Characteristics;
463} IMAGE_TLS_DIRECTORY32;
464typedef IMAGE_TLS_DIRECTORY32 *PIMAGE_TLS_DIRECTORY32;
465
466typedef struct _IMAGE_TLS_DIRECTORY64
467{
468 KU64 StartAddressOfRawData;
469 KU64 EndAddressOfRawData;
470 KU64 AddressOfIndex;
471 KU64 AddressOfCallBacks;
472 KU32 SizeOfZeroFill;
473 KU32 Characteristics;
474} IMAGE_TLS_DIRECTORY64;
475typedef IMAGE_TLS_DIRECTORY64 *PIMAGE_TLS_DIRECTORY64;
476
477
478#pragma pack()
479
480#endif
481
Note: See TracBrowser for help on using the repository browser.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette