]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - include/coff/pe.h
projects / thirdparty / binutils-gdb.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Extend the description of PE header flags.
[thirdparty/binutils-gdb.git] / include / coff / pe.h
CommitLineData
61e2488c 1/* pe.h - PE COFF header information
252b5132 2
250d07de 3 Copyright (C) 1999-2021 Free Software Foundation, Inc.
d155c6ea
NC		 4
5 This file is part of BFD, the Binary File Descriptor library.
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
e4e42b45 9 the Free Software Foundation; either version 3 of the License, or
d155c6ea
NC		 10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software Foundation,
e172dbf8 19 Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */
252b5132
RH		 20#ifndef _PE_H
21#define _PE_H
22
830db048
ZF		 23#include "msdos.h"
24
cbaede9c 25/* NT specific file attributes. */
252b5132
RH		 26#define IMAGE_FILE_RELOCS_STRIPPED 0x0001
27#define IMAGE_FILE_EXECUTABLE_IMAGE 0x0002
28#define IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004
29#define IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008
cbaede9c
NC		 30#define IMAGE_FILE_AGGRESSIVE_WS_TRIM 0x0010
31#define IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020
32#define IMAGE_FILE_16BIT_MACHINE 0x0040
252b5132
RH		 33#define IMAGE_FILE_BYTES_REVERSED_LO 0x0080
34#define IMAGE_FILE_32BIT_MACHINE 0x0100
35#define IMAGE_FILE_DEBUG_STRIPPED 0x0200
cbaede9c 36#define IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400
93e49a47 37#define IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800
252b5132
RH		 38#define IMAGE_FILE_SYSTEM 0x1000
39#define IMAGE_FILE_DLL 0x2000
cbaede9c 40#define IMAGE_FILE_UP_SYSTEM_ONLY 0x4000
252b5132
RH		 41#define IMAGE_FILE_BYTES_REVERSED_HI 0x8000
42
2f563b51
DK		 43/* DllCharacteristics flag bits. The inconsistent naming may seem
44 odd, but that is how they are defined in the PE specification. */
2d5c3743 45#define IMAGE_DLL_CHARACTERISTICS_HIGH_ENTROPY_VA 0x0020
2f563b51
DK		 46#define IMAGE_DLL_CHARACTERISTICS_DYNAMIC_BASE 0x0040
47#define IMAGE_DLL_CHARACTERISTICS_FORCE_INTEGRITY 0x0080
48#define IMAGE_DLL_CHARACTERISTICS_NX_COMPAT 0x0100
49#define IMAGE_DLLCHARACTERISTICS_NO_ISOLATION 0x0200
50#define IMAGE_DLLCHARACTERISTICS_NO_SEH 0x0400
51#define IMAGE_DLLCHARACTERISTICS_NO_BIND 0x0800
18e9a809 52#define IMAGE_DLLCHARACTERISTICS_APPCONTAINER 0x1000
2f563b51 53#define IMAGE_DLLCHARACTERISTICS_WDM_DRIVER 0x2000
18e9a809 54#define IMAGE_DLLCHARACTERISTICS_GUARD_CF 0x4000
2f563b51
DK		 55#define IMAGE_DLLCHARACTERISTICS_TERMINAL_SERVER_AWARE 0x8000
56
cbaede9c 57/* Additional flags to be set for section headers to allow the NT loader to
252b5132 58 read and write to the section data (to replace the addresses of data in
cbaede9c 59 dlls for one thing); also to execute the section in .text's case. */
252b5132
RH		 60#define IMAGE_SCN_MEM_DISCARDABLE 0x02000000
61#define IMAGE_SCN_MEM_EXECUTE 0x20000000
62#define IMAGE_SCN_MEM_READ 0x40000000
63#define IMAGE_SCN_MEM_WRITE 0x80000000
64
cbaede9c 65/* Section characteristics added for ppc-nt. */
252b5132 66
2d5c3743 67#define IMAGE_SCN_TYPE_NO_PAD 0x00000008 /* Reserved. */
252b5132 68
2d5c3743
NC		 69#define IMAGE_SCN_CNT_CODE 0x00000020 /* Section contains code. */
70#define IMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040 /* Section contains initialized data. */
71#define IMAGE_SCN_CNT_UNINITIALIZED_DATA 0x00000080 /* Section contains uninitialized data. */
252b5132 72
2d5c3743
NC		 73#define IMAGE_SCN_LNK_OTHER 0x00000100 /* Reserved. */
74#define IMAGE_SCN_LNK_INFO 0x00000200 /* Section contains comments or some other type of information. */
75#define IMAGE_SCN_LNK_REMOVE 0x00000800 /* Section contents will not become part of image. */
76#define IMAGE_SCN_LNK_COMDAT 0x00001000 /* Section contents comdat. */
252b5132
RH		 77
78#define IMAGE_SCN_MEM_FARDATA 0x00008000
79
80#define IMAGE_SCN_MEM_PURGEABLE 0x00020000
81#define IMAGE_SCN_MEM_16BIT 0x00020000
82#define IMAGE_SCN_MEM_LOCKED 0x00040000
83#define IMAGE_SCN_MEM_PRELOAD 0x00080000
84
2d5c3743 85/* Bit position in the s_flags field where the alignment values start. */
bd33be6e
L		 86#define IMAGE_SCN_ALIGN_POWER_BIT_POS 20
87#define IMAGE_SCN_ALIGN_POWER_BIT_MASK 0x00f00000
88#define IMAGE_SCN_ALIGN_POWER_NUM(val) \
89 (((val) >> IMAGE_SCN_ALIGN_POWER_BIT_POS) - 1)
90#define IMAGE_SCN_ALIGN_POWER_CONST(val) \
91 (((val) + 1) << IMAGE_SCN_ALIGN_POWER_BIT_POS)
92
93#define IMAGE_SCN_ALIGN_1BYTES IMAGE_SCN_ALIGN_POWER_CONST (0)
94#define IMAGE_SCN_ALIGN_2BYTES IMAGE_SCN_ALIGN_POWER_CONST (1)
95#define IMAGE_SCN_ALIGN_4BYTES IMAGE_SCN_ALIGN_POWER_CONST (2)
96#define IMAGE_SCN_ALIGN_8BYTES IMAGE_SCN_ALIGN_POWER_CONST (3)
2d5c3743 97/* Default alignment if no others are specified. */
bd33be6e
L		 98#define IMAGE_SCN_ALIGN_16BYTES IMAGE_SCN_ALIGN_POWER_CONST (4)
99#define IMAGE_SCN_ALIGN_32BYTES IMAGE_SCN_ALIGN_POWER_CONST (5)
100#define IMAGE_SCN_ALIGN_64BYTES IMAGE_SCN_ALIGN_POWER_CONST (6)
101#define IMAGE_SCN_ALIGN_128BYTES IMAGE_SCN_ALIGN_POWER_CONST (7)
102#define IMAGE_SCN_ALIGN_256BYTES IMAGE_SCN_ALIGN_POWER_CONST (8)
103#define IMAGE_SCN_ALIGN_512BYTES IMAGE_SCN_ALIGN_POWER_CONST (9)
104#define IMAGE_SCN_ALIGN_1024BYTES IMAGE_SCN_ALIGN_POWER_CONST (10)
105#define IMAGE_SCN_ALIGN_2048BYTES IMAGE_SCN_ALIGN_POWER_CONST (11)
106#define IMAGE_SCN_ALIGN_4096BYTES IMAGE_SCN_ALIGN_POWER_CONST (12)
107#define IMAGE_SCN_ALIGN_8192BYTES IMAGE_SCN_ALIGN_POWER_CONST (13)
252b5132 108
2d5c3743 109/* Encode alignment power into IMAGE_SCN_ALIGN bits of s_flags. */
6f8f6017
AM		 110#define COFF_ENCODE_ALIGNMENT(ABFD, SECTION, ALIGNMENT_POWER) \
111 (((ABFD)->flags & (EXEC_P | DYNAMIC)) != 0 ? false \
112 : ((SECTION).s_flags \
113 |= IMAGE_SCN_ALIGN_POWER_CONST ((ALIGNMENT_POWER) < 13 \
114 ? (ALIGNMENT_POWER) : 13), \
115 true))
5be87c8f
JB		 116#define COFF_DECODE_ALIGNMENT(X) \
117 IMAGE_SCN_ALIGN_POWER_NUM ((X) & IMAGE_SCN_ALIGN_POWER_BIT_MASK)
11ec4ba9 118
252b5132
RH		 119#define IMAGE_SCN_LNK_NRELOC_OVFL 0x01000000 /* Section contains extended relocations. */
120#define IMAGE_SCN_MEM_NOT_CACHED 0x04000000 /* Section is not cachable. */
121#define IMAGE_SCN_MEM_NOT_PAGED 0x08000000 /* Section is not pageable. */
122#define IMAGE_SCN_MEM_SHARED 0x10000000 /* Section is shareable. */
123
124/* COMDAT selection codes. */
125
126#define IMAGE_COMDAT_SELECT_NODUPLICATES (1) /* Warn if duplicates. */
127#define IMAGE_COMDAT_SELECT_ANY (2) /* No warning. */
128#define IMAGE_COMDAT_SELECT_SAME_SIZE (3) /* Warn if different size. */
129#define IMAGE_COMDAT_SELECT_EXACT_MATCH (4) /* Warn if different. */
130#define IMAGE_COMDAT_SELECT_ASSOCIATIVE (5) /* Base on other section. */
131
cbaede9c
NC		 132/* Machine numbers. */
133
93e49a47
NC		 134#define IMAGE_FILE_MACHINE_UNKNOWN 0x0000
135#define IMAGE_FILE_MACHINE_ALPHA 0x0184
136#define IMAGE_FILE_MACHINE_ALPHA64 0x0284
137#define IMAGE_FILE_MACHINE_AM33 0x01d3
138#define IMAGE_FILE_MACHINE_AMD64 0x8664
139#define IMAGE_FILE_MACHINE_ARM 0x01c0
140#define IMAGE_FILE_MACHINE_AXP64 IMAGE_FILE_MACHINE_ALPHA64
141#define IMAGE_FILE_MACHINE_CEE 0xc0ee
142#define IMAGE_FILE_MACHINE_CEF 0x0cef
143#define IMAGE_FILE_MACHINE_EBC 0x0ebc
144#define IMAGE_FILE_MACHINE_I386 0x014c
145#define IMAGE_FILE_MACHINE_IA64 0x0200
146#define IMAGE_FILE_MACHINE_M32R 0x9041
147#define IMAGE_FILE_MACHINE_M68K 0x0268
148#define IMAGE_FILE_MACHINE_MIPS16 0x0266
149#define IMAGE_FILE_MACHINE_MIPSFPU 0x0366
150#define IMAGE_FILE_MACHINE_MIPSFPU16 0x0466
151#define IMAGE_FILE_MACHINE_POWERPC 0x01f0
152#define IMAGE_FILE_MACHINE_POWERPCFP 0x01f1
153#define IMAGE_FILE_MACHINE_R10000 0x0168
154#define IMAGE_FILE_MACHINE_R3000 0x0162
155#define IMAGE_FILE_MACHINE_R4000 0x0166
156#define IMAGE_FILE_MACHINE_SH3 0x01a2
157#define IMAGE_FILE_MACHINE_SH3DSP 0x01a3
158#define IMAGE_FILE_MACHINE_SH3E 0x01a4
159#define IMAGE_FILE_MACHINE_SH4 0x01a6
160#define IMAGE_FILE_MACHINE_SH5 0x01a8
161#define IMAGE_FILE_MACHINE_THUMB 0x01c2
162#define IMAGE_FILE_MACHINE_TRICORE 0x0520
163#define IMAGE_FILE_MACHINE_WCEMIPSV2 0x0169
99ad8390 164#define IMAGE_FILE_MACHINE_AMD64 0x8664
93e49a47 165
63fa1674
JW		 166#define IMAGE_SUBSYSTEM_UNKNOWN 0
167#define IMAGE_SUBSYSTEM_NATIVE 1
168#define IMAGE_SUBSYSTEM_WINDOWS_GUI 2
169#define IMAGE_SUBSYSTEM_WINDOWS_CUI 3
170#define IMAGE_SUBSYSTEM_POSIX_CUI 7
171#define IMAGE_SUBSYSTEM_WINDOWS_CE_GUI 9
172#define IMAGE_SUBSYSTEM_EFI_APPLICATION 10
173#define IMAGE_SUBSYSTEM_EFI_BOOT_SERVICE_DRIVER 11
174#define IMAGE_SUBSYSTEM_EFI_RUNTIME_DRIVER 12
d9118602 175#define IMAGE_SUBSYSTEM_SAL_RUNTIME_DRIVER 13
6c73cbb1 176#define IMAGE_SUBSYSTEM_XBOX 14
61e2488c 177
d155c6ea
NC		 178/* NT allows long filenames, we want to accommodate this.
179 This may break some of the bfd functions. */
252b5132 180#undef FILNMLEN
d155c6ea 181#define FILNMLEN 18 /* # characters in a file name. */
252b5132 182
98536290
L		 183struct external_PEI_IMAGE_hdr
184{
2d5c3743 185 char nt_signature[4]; /* Required NT signature, 0x4550. */
98536290
L		 186
187 /* From standard header. */
188 char f_magic[2]; /* Magic number. */
189 char f_nscns[2]; /* Number of sections. */
190 char f_timdat[4]; /* Time & date stamp. */
191 char f_symptr[4]; /* File pointer to symtab. */
192 char f_nsyms[4]; /* Number of symtab entries. */
193 char f_opthdr[2]; /* Sizeof(optional hdr). */
194 char f_flags[2]; /* Flags. */
195};
196
25bcc51d 197struct external_PEI_filehdr
252b5132 198{
d155c6ea
NC		 199 /* DOS header fields - always at offset zero in the EXE file. */
200 char e_magic[2]; /* Magic number, 0x5a4d. */
201 char e_cblp[2]; /* Bytes on last page of file, 0x90. */
202 char e_cp[2]; /* Pages in file, 0x3. */
203 char e_crlc[2]; /* Relocations, 0x0. */
204 char e_cparhdr[2]; /* Size of header in paragraphs, 0x4. */
205 char e_minalloc[2]; /* Minimum extra paragraphs needed, 0x0. */
206 char e_maxalloc[2]; /* Maximum extra paragraphs needed, 0xFFFF. */
207 char e_ss[2]; /* Initial (relative) SS value, 0x0. */
208 char e_sp[2]; /* Initial SP value, 0xb8. */
209 char e_csum[2]; /* Checksum, 0x0. */
210 char e_ip[2]; /* Initial IP value, 0x0. */
211 char e_cs[2]; /* Initial (relative) CS value, 0x0. */
212 char e_lfarlc[2]; /* File address of relocation table, 0x40. */
213 char e_ovno[2]; /* Overlay number, 0x0. */
214 char e_res[4][2]; /* Reserved words, all 0x0. */
215 char e_oemid[2]; /* OEM identifier (for e_oeminfo), 0x0. */
216 char e_oeminfo[2]; /* OEM information; e_oemid specific, 0x0. */
217 char e_res2[10][2]; /* Reserved words, all 0x0. */
218 char e_lfanew[4]; /* File address of new exe header, usually 0x80. */
219 char dos_message[16][4]; /* Other stuff, always follow DOS header. */
c689311b
DD		 220
221 /* Note: additional bytes may be inserted before the signature. Use
d155c6ea
NC		 222 the e_lfanew field to find the actual location of the NT signature. */
223
2d5c3743 224 char nt_signature[4]; /* Required NT signature, 0x4550. */
d155c6ea
NC		 225
226 /* From standard header. */
227 char f_magic[2]; /* Magic number. */
228 char f_nscns[2]; /* Number of sections. */
229 char f_timdat[4]; /* Time & date stamp. */
230 char f_symptr[4]; /* File pointer to symtab. */
231 char f_nsyms[4]; /* Number of symtab entries. */
232 char f_opthdr[2]; /* Sizeof(optional hdr). */
233 char f_flags[2]; /* Flags. */
252b5132
RH		 234};
235
25bcc51d
ILT		 236#ifdef COFF_IMAGE_WITH_PE
237
cbaede9c 238/* The filehdr is only weird in images. */
252b5132 239
cbaede9c 240#undef FILHDR
25bcc51d 241#define FILHDR struct external_PEI_filehdr
cbaede9c 242#undef FILHSZ
252b5132
RH		 243#define FILHSZ 152
244
25bcc51d 245#endif /* COFF_IMAGE_WITH_PE */
252b5132 246
2d5c3743 247/* 32-bit PE a.out header: */
63fa1674 248
61e2488c 249typedef struct
252b5132
RH		 250{
251 AOUTHDR standard;
252
d155c6ea 253 /* NT extra fields; see internal.h for descriptions. */
252b5132
RH		 254 char ImageBase[4];
255 char SectionAlignment[4];
256 char FileAlignment[4];
257 char MajorOperatingSystemVersion[2];
258 char MinorOperatingSystemVersion[2];
259 char MajorImageVersion[2];
260 char MinorImageVersion[2];
261 char MajorSubsystemVersion[2];
262 char MinorSubsystemVersion[2];
263 char Reserved1[4];
264 char SizeOfImage[4];
265 char SizeOfHeaders[4];
266 char CheckSum[4];
267 char Subsystem[2];
268 char DllCharacteristics[2];
269 char SizeOfStackReserve[4];
270 char SizeOfStackCommit[4];
271 char SizeOfHeapReserve[4];
272 char SizeOfHeapCommit[4];
273 char LoaderFlags[4];
274 char NumberOfRvaAndSizes[4];
d155c6ea
NC		 275 /* IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; */
276 char DataDirectory[16][2][4]; /* 16 entries, 2 elements/entry, 4 chars. */
252b5132 277} PEAOUTHDR;
99ad8390 278
252b5132
RH		 279#undef AOUTSZ
280#define AOUTSZ (AOUTHDRSZ + 196)
281
63fa1674
JW		 282/* Like PEAOUTHDR, except that the "standard" member has no BaseOfData
283 (aka data_start) member and that some of the members are 8 instead
284 of just 4 bytes long. */
61e2488c 285typedef struct
63fa1674 286{
99ad8390
NC		 287#ifdef AOUTHDRSZ64
288 AOUTHDR64 standard;
289#else
63fa1674 290 AOUTHDR standard;
99ad8390 291#endif
d155c6ea 292 /* NT extra fields; see internal.h for descriptions. */
63fa1674
JW		 293 char ImageBase[8];
294 char SectionAlignment[4];
295 char FileAlignment[4];
296 char MajorOperatingSystemVersion[2];
297 char MinorOperatingSystemVersion[2];
298 char MajorImageVersion[2];
299 char MinorImageVersion[2];
300 char MajorSubsystemVersion[2];
301 char MinorSubsystemVersion[2];
302 char Reserved1[4];
303 char SizeOfImage[4];
304 char SizeOfHeaders[4];
305 char CheckSum[4];
306 char Subsystem[2];
307 char DllCharacteristics[2];
308 char SizeOfStackReserve[8];
309 char SizeOfStackCommit[8];
310 char SizeOfHeapReserve[8];
311 char SizeOfHeapCommit[8];
312 char LoaderFlags[4];
313 char NumberOfRvaAndSizes[4];
d155c6ea
NC		 314 /* IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; */
315 char DataDirectory[16][2][4]; /* 16 entries, 2 elements/entry, 4 chars. */
c9430732 316} PEPAOUTHDR;
99ad8390
NC		 317
318#ifdef AOUTHDRSZ64
319#define PEPAOUTSZ (AOUTHDRSZ64 + 196 + 5 * 4) /* = 240 */
320#else
c9430732 321#define PEPAOUTSZ 240
99ad8390 322#endif
61e2488c 323
252b5132 324#undef E_FILNMLEN
d155c6ea 325#define E_FILNMLEN 18 /* # characters in a file name. */
056350c6
NC		 326
327/* Import Tyoes fot ILF format object files.. */
328#define IMPORT_CODE 0
329#define IMPORT_DATA 1
330#define IMPORT_CONST 2
331
332/* Import Name Tyoes for ILF format object files. */
333#define IMPORT_ORDINAL 0
334#define IMPORT_NAME 1
335#define IMPORT_NAME_NOPREFIX 2
336#define IMPORT_NAME_UNDECORATE 3
337
977cdf5a
NC		 338/* Weak external characteristics. */
339#define IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY 1
340#define IMAGE_WEAK_EXTERN_SEARCH_LIBRARY 2
341#define IMAGE_WEAK_EXTERN_SEARCH_ALIAS 3
342
167ad85b
TG		 343/* Bigobj header. */
344struct external_ANON_OBJECT_HEADER_BIGOBJ
345{
346 /* ANON_OBJECT_HEADER_V2 header. */
347 char Sig1[2];
348 char Sig2[2];
349 char Version[2];
350 char Machine[2];
351 char TimeDateStamp[4];
352 char ClassID[16];
353 char SizeOfData[4];
354 char Flags[4];
355 char MetaDataSize[4];
356 char MetaDataOffset[4];
357
358 /* BIGOBJ specific. */
359 char NumberOfSections[4];
360 char PointerToSymbolTable[4];
361 char NumberOfSymbols[4];
362};
363
364#define FILHSZ_BIGOBJ (14 * 4)
365
366struct external_SYMBOL_EX
367{
368 union
369 {
370 char e_name[E_SYMNMLEN];
371
372 struct
373 {
374 char e_zeroes[4];
375 char e_offset[4];
376 } e;
377 } e;
378
379 char e_value[4];
380 char e_scnum[4];
381 char e_type[2];
382 char e_sclass[1];
383 char e_numaux[1];
384} ATTRIBUTE_PACKED ;
385
386#define SYMENT_BIGOBJ struct external_SYMBOL_EX
387#define SYMESZ_BIGOBJ 20
388
389#define FILNMLEN_BIGOBJ 20
390
391union external_AUX_SYMBOL_EX
392{
393 struct
394 {
395 char WeakDefaultSymIndex[4];
396 char WeakSearchType[4];
397 char rgbReserved[12];
398 } Sym;
399
400 struct
401 {
402 char Name[FILNMLEN_BIGOBJ];
403 } File;
404
405 struct
406 {
2d5c3743
NC		 407 char Length[4]; /* Section length. */
408 char NumberOfRelocations[2];/* # relocation entries. */
409 char NumberOfLinenumbers[2];/* # line numbers. */
410 char Checksum[4]; /* Section COMDAT checksum. */
411 char Number[2]; /* COMDAT associated section index. */
412 char Selection[1]; /* COMDAT selection number. */
167ad85b 413 char bReserved[1];
2d5c3743 414 char HighNumber[2]; /* High bits of COMDAT associated sec. */
167ad85b
TG		 415 char rgbReserved[2];
416 } Section;
417} ATTRIBUTE_PACKED;
418
419#define AUXENT_BIGOBJ union external_AUX_SYMBOL_EX
420#define AUXESZ_BIGOBJ 20
421
e48570bb
DK		 422/* .pdata/.xdata defines and structures for x64 PE+ for exception handling. */
423
424/* .pdata in exception directory. */
425
426struct pex64_runtime_function
427{
428 bfd_vma rva_BeginAddress;
429 bfd_vma rva_EndAddress;
430 bfd_vma rva_UnwindData;
e48570bb
DK		 431};
432
433struct external_pex64_runtime_function
434{
435 bfd_byte rva_BeginAddress[4];
436 bfd_byte rva_EndAddress[4];
437 bfd_byte rva_UnwindData[4];
438};
439
440/* If the lowest significant bit is set for rva_UnwindData RVA, it
441 means that the unified RVA points to another pex64_runtime_function
442 that this entry shares the unwind_info block with. */
443#define PEX64_IS_RUNTIME_FUNCTION_CHAINED(PTR_RTF) \
444 (((PTR_RTF)->rva_UnwindData & 1) != 0)
445#define PEX64_GET_UNWINDDATA_UNIFIED_RVA(PTR_RTF) \
446 ((PTR_RTF)->rva_UnwindData & ~1)
447
448/* The unwind codes. */
449#define UWOP_PUSH_NONVOL 0
450#define UWOP_ALLOC_LARGE 1
451#define UWOP_ALLOC_SMALL 2
452#define UWOP_SET_FPREG 3
453#define UWOP_SAVE_NONVOL 4
454#define UWOP_SAVE_NONVOL_FAR 5
2b597f54
TG		 455#define UWOP_SAVE_XMM 6 /* For version 1. */
456#define UWOP_EPILOG 6 /* For version 2. */
457#define UWOP_SAVE_XMM_FAR 7 /* For version 1 (deprecated). */
458#define UWOP_SPARE 7 /* For version 2. */
e48570bb
DK		 459#define UWOP_SAVE_XMM128 8
460#define UWOP_SAVE_XMM128_FAR 9
461#define UWOP_PUSH_MACHFRAME 10
462
463struct pex64_unwind_code
464{
465 bfd_vma prologue_offset;
466 /* Contains Frame offset, or frame allocation size. */
467 bfd_vma frame_addr;
468 unsigned int uwop_code : 4;
469 /* xmm, mm, or standard register from 0 - 15. */
470 unsigned int reg : 4;
471 /* Used for UWOP_PUSH_MACHFRAME to indicate optional errorcode stack
472 argument. */
473 unsigned int has_errorcode : 1;
474};
475
476struct external_pex64_unwind_code
477{
478 bfd_byte dta[2];
479};
480
481#define PEX64_UNWCODE_CODE(VAL) ((VAL) & 0xf)
482#define PEX64_UNWCODE_INFO(VAL) (((VAL) >> 4) & 0xf)
483
484/* The unwind info. */
485#define UNW_FLAG_NHANDLER 0
486#define UNW_FLAG_EHANDLER 1
487#define UNW_FLAG_UHANDLER 2
488#define UNW_FLAG_FHANDLER 3
489#define UNW_FLAG_CHAININFO 4
490
491#define UNW_FLAG_MASK 0x1f
492
493struct pex64_unwind_info
494{
495 bfd_vma SizeOfBlock;
496 bfd_byte Version; /* Values from 0 up to 7 are possible. */
497 bfd_byte Flags; /* Values from 0 up to 31 are possible. */
498 bfd_vma SizeOfPrologue;
499 bfd_vma CountOfCodes; /* Amount of pex64_unwind_code elements. */
500 /* 0 = CFA, 1..15 are index of integer registers. */
501 unsigned int FrameRegister : 4;
502 bfd_vma FrameOffset;
503 bfd_vma sizeofUnwindCodes;
504 bfd_byte *rawUnwindCodes;
3e33b239 505 bfd_byte *rawUnwindCodesEnd;
48d5accb
TG		 506 bfd_vma rva_ExceptionHandler; /* UNW_EHANDLER or UNW_FLAG_UHANDLER. */
507 bfd_vma rva_BeginAddress; /* UNW_FLAG_CHAININFO. */
508 bfd_vma rva_EndAddress; /* UNW_FLAG_CHAININFO. */
509 bfd_vma rva_UnwindData; /* UNW_FLAG_CHAININFO. */
e48570bb
DK		 510};
511
512struct external_pex64_unwind_info
513{
514 bfd_byte Version_Flags;
515 bfd_byte SizeOfPrologue;
516 bfd_byte CountOfCodes;
517 bfd_byte FrameRegisterOffset;
518 /* external_pex64_unwind_code array. */
519 /* bfd_byte handler[4]; */
520 /* Optional language specific data. */
521};
522
523struct external_pex64_scope
524{
525 bfd_vma Count;
526};
527
528struct pex64_scope
529{
530 bfd_byte Count[4];
531};
532
533struct pex64_scope_entry
534{
535 bfd_vma rva_BeginAddress;
536 bfd_vma rva_EndAddress;
537 bfd_vma rva_HandlerAddress;
538 bfd_vma rva_JumpAddress;
539};
540#define PEX64_SCOPE_ENTRY_SIZE 16
541
542struct external_pex64_scope_entry
543{
544 bfd_byte rva_BeginAddress[4];
545 bfd_byte rva_EndAddress[4];
546 bfd_byte rva_HandlerAddress[4];
547 bfd_byte rva_JumpAddress[4];
548};
549
550#define PEX64_UWI_VERSION(VAL) ((VAL) & 7)
551#define PEX64_UWI_FLAGS(VAL) (((VAL) >> 3) & 0x1f)
552#define PEX64_UWI_FRAMEREG(VAL) ((VAL) & 0xf)
553#define PEX64_UWI_FRAMEOFF(VAL) (((VAL) >> 4) & 0xf)
554#define PEX64_UWI_SIZEOF_UWCODE_ARRAY(VAL) \
555 ((((VAL) + 1) & ~1) * 2)
556
557#define PEX64_OFFSET_TO_UNWIND_CODE 0x4
558
559#define PEX64_OFFSET_TO_HANDLER_RVA (COUNTOFUNWINDCODES) \
560 (PEX64_OFFSET_TO_UNWIND_CODE + \
561 PEX64_UWI_SIZEOF_UWCODE_ARRAY(COUNTOFUNWINDCODES))
562
563#define PEX64_OFFSET_TO_SCOPE_COUNT(COUNTOFUNWINDCODES) \
564 (PEX64_OFFSET_TO_HANDLER_RVA(COUNTOFUNWINDCODES) + 4)
565
566#define PEX64_SCOPE_ENTRY(COUNTOFUNWINDCODES, IDX) \
567 (PEX64_OFFSET_TO_SCOPE_COUNT(COUNTOFUNWINDCODES) + \
568 PEX64_SCOPE_ENTRY_SIZE * (IDX))
569
2d5c3743
NC		 570/* Extra structure used in debug directory. */
571struct external_IMAGE_DEBUG_DIRECTORY
572{
61e2488c
JT		 573 char Characteristics[4];
574 char TimeDateStamp[4];
575 char MajorVersion[2];
576 char MinorVersion[2];
577 char Type[4];
578 char SizeOfData[4];
579 char AddressOfRawData[4];
580 char PointerToRawData[4];
581};
582
2d5c3743
NC		 583/* Extra structures used in codeview debug record. */
584/* This is not part of the PE specification. */
61e2488c 585
279edac5
AM		 586#define CVINFO_PDB70_CVSIGNATURE 0x53445352 /* "RSDS" */
587#define CVINFO_PDB20_CVSIGNATURE 0x3031424e /* "NB10" */
588#define CVINFO_CV50_CVSIGNATURE 0x3131424e /* "NB11" */
589#define CVINFO_CV41_CVSIGNATURE 0x3930424e /* "NB09" */
61e2488c
JT		 590
591typedef struct _CV_INFO_PDB70
592{
593 char CvSignature[4];
594 char Signature[16];
595 char Age[4];
596 char PdbFileName[];
597} CV_INFO_PDB70;
598
599typedef struct _CV_INFO_PDB20
600{
601 char CvHeader[4];
602 char Offset[4];
603 char Signature[4];
604 char Age[4];
605 char PdbFileName[];
606} CV_INFO_PDB20;
607
056350c6 608#endif /* _PE_H */
A mirror of the official binutils-gdb repository