source: trunk/binutils/include/coff/pe.h@ 2589

Last change on this file since 2589 was 10, checked in by bird, 23 years ago

Initial revision
  • Property cvs2svn:cvs-rev set to 1.1
  • Property svn:eol-style set to native
  • Property svn:executable set to *
File size: 12.0 KB
Line 
1/* pe.h - PE COFF header information
2
3 Copyright 2000, 2001 Free Software Foundation, Inc.
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
9 the Free Software Foundation; either version 2 of the License, or
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,
19 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
20#ifndef _PE_H
21#define _PE_H
22
23/* NT specific file attributes. */
24#define IMAGE_FILE_RELOCS_STRIPPED 0x0001
25#define IMAGE_FILE_EXECUTABLE_IMAGE 0x0002
26#define IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004
27#define IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008
28#define IMAGE_FILE_AGGRESSIVE_WS_TRIM 0x0010
29#define IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020
30#define IMAGE_FILE_16BIT_MACHINE 0x0040
31#define IMAGE_FILE_BYTES_REVERSED_LO 0x0080
32#define IMAGE_FILE_32BIT_MACHINE 0x0100
33#define IMAGE_FILE_DEBUG_STRIPPED 0x0200
34#define IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400
35#define IMAGE_FILE_SYSTEM 0x1000
36#define IMAGE_FILE_DLL 0x2000
37#define IMAGE_FILE_UP_SYSTEM_ONLY 0x4000
38#define IMAGE_FILE_BYTES_REVERSED_HI 0x8000
39
40/* Additional flags to be set for section headers to allow the NT loader to
41 read and write to the section data (to replace the addresses of data in
42 dlls for one thing); also to execute the section in .text's case. */
43#define IMAGE_SCN_MEM_DISCARDABLE 0x02000000
44#define IMAGE_SCN_MEM_EXECUTE 0x20000000
45#define IMAGE_SCN_MEM_READ 0x40000000
46#define IMAGE_SCN_MEM_WRITE 0x80000000
47
48/* Section characteristics added for ppc-nt. */
49
50#define IMAGE_SCN_TYPE_NO_PAD 0x00000008 /* Reserved. */
51
52#define IMAGE_SCN_CNT_CODE 0x00000020 /* Section contains code. */
53#define IMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040 /* Section contains initialized data. */
54#define IMAGE_SCN_CNT_UNINITIALIZED_DATA 0x00000080 /* Section contains uninitialized data. */
55
56#define IMAGE_SCN_LNK_OTHER 0x00000100 /* Reserved. */
57#define IMAGE_SCN_LNK_INFO 0x00000200 /* Section contains comments or some other type of information. */
58#define IMAGE_SCN_LNK_REMOVE 0x00000800 /* Section contents will not become part of image. */
59#define IMAGE_SCN_LNK_COMDAT 0x00001000 /* Section contents comdat. */
60
61#define IMAGE_SCN_MEM_FARDATA 0x00008000
62
63#define IMAGE_SCN_MEM_PURGEABLE 0x00020000
64#define IMAGE_SCN_MEM_16BIT 0x00020000
65#define IMAGE_SCN_MEM_LOCKED 0x00040000
66#define IMAGE_SCN_MEM_PRELOAD 0x00080000
67
68#define IMAGE_SCN_ALIGN_1BYTES 0x00100000
69#define IMAGE_SCN_ALIGN_2BYTES 0x00200000
70#define IMAGE_SCN_ALIGN_4BYTES 0x00300000
71#define IMAGE_SCN_ALIGN_8BYTES 0x00400000
72#define IMAGE_SCN_ALIGN_16BYTES 0x00500000 /* Default alignment if no others are specified. */
73#define IMAGE_SCN_ALIGN_32BYTES 0x00600000
74#define IMAGE_SCN_ALIGN_64BYTES 0x00700000
75
76#define IMAGE_SCN_LNK_NRELOC_OVFL 0x01000000 /* Section contains extended relocations. */
77#define IMAGE_SCN_MEM_NOT_CACHED 0x04000000 /* Section is not cachable. */
78#define IMAGE_SCN_MEM_NOT_PAGED 0x08000000 /* Section is not pageable. */
79#define IMAGE_SCN_MEM_SHARED 0x10000000 /* Section is shareable. */
80
81/* COMDAT selection codes. */
82
83#define IMAGE_COMDAT_SELECT_NODUPLICATES (1) /* Warn if duplicates. */
84#define IMAGE_COMDAT_SELECT_ANY (2) /* No warning. */
85#define IMAGE_COMDAT_SELECT_SAME_SIZE (3) /* Warn if different size. */
86#define IMAGE_COMDAT_SELECT_EXACT_MATCH (4) /* Warn if different. */
87#define IMAGE_COMDAT_SELECT_ASSOCIATIVE (5) /* Base on other section. */
88
89/* Machine numbers. */
90
91#define IMAGE_FILE_MACHINE_UNKNOWN 0x0
92#define IMAGE_FILE_MACHINE_ALPHA 0x184
93#define IMAGE_FILE_MACHINE_ARM 0x1c0
94#define IMAGE_FILE_MACHINE_ALPHA64 0x284
95#define IMAGE_FILE_MACHINE_I386 0x14c
96#define IMAGE_FILE_MACHINE_IA64 0x200
97#define IMAGE_FILE_MACHINE_M68K 0x268
98#define IMAGE_FILE_MACHINE_MIPS16 0x266
99#define IMAGE_FILE_MACHINE_MIPSFPU 0x366
100#define IMAGE_FILE_MACHINE_MIPSFPU16 0x466
101#define IMAGE_FILE_MACHINE_POWERPC 0x1f0
102#define IMAGE_FILE_MACHINE_R3000 0x162
103#define IMAGE_FILE_MACHINE_R4000 0x166
104#define IMAGE_FILE_MACHINE_R10000 0x168
105#define IMAGE_FILE_MACHINE_SH3 0x1a2
106#define IMAGE_FILE_MACHINE_SH4 0x1a6
107#define IMAGE_FILE_MACHINE_THUMB 0x1c2
108
109#define IMAGE_SUBSYSTEM_UNKNOWN 0
110#define IMAGE_SUBSYSTEM_NATIVE 1
111#define IMAGE_SUBSYSTEM_WINDOWS_GUI 2
112#define IMAGE_SUBSYSTEM_WINDOWS_CUI 3
113#define IMAGE_SUBSYSTEM_POSIX_CUI 7
114#define IMAGE_SUBSYSTEM_WINDOWS_CE_GUI 9
115#define IMAGE_SUBSYSTEM_EFI_APPLICATION 10
116#define IMAGE_SUBSYSTEM_EFI_BOOT_SERVICE_DRIVER 11
117#define IMAGE_SUBSYSTEM_EFI_RUNTIME_DRIVER 12
118
119/* Magic values that are true for all dos/nt implementations. */
120#define DOSMAGIC 0x5a4d
121#define NT_SIGNATURE 0x00004550
122
123/* NT allows long filenames, we want to accommodate this.
124 This may break some of the bfd functions. */
125#undef FILNMLEN
126#define FILNMLEN 18 /* # characters in a file name. */
127
128struct external_PEI_DOS_hdr
129{
130 /* DOS header fields - always at offset zero in the EXE file. */
131 char e_magic[2]; /* Magic number, 0x5a4d. */
132 char e_cblp[2]; /* Bytes on last page of file, 0x90. */
133 char e_cp[2]; /* Pages in file, 0x3. */
134 char e_crlc[2]; /* Relocations, 0x0. */
135 char e_cparhdr[2]; /* Size of header in paragraphs, 0x4. */
136 char e_minalloc[2]; /* Minimum extra paragraphs needed, 0x0. */
137 char e_maxalloc[2]; /* Maximum extra paragraphs needed, 0xFFFF. */
138 char e_ss[2]; /* Initial (relative) SS value, 0x0. */
139 char e_sp[2]; /* Initial SP value, 0xb8. */
140 char e_csum[2]; /* Checksum, 0x0. */
141 char e_ip[2]; /* Initial IP value, 0x0. */
142 char e_cs[2]; /* Initial (relative) CS value, 0x0. */
143 char e_lfarlc[2]; /* File address of relocation table, 0x40. */
144 char e_ovno[2]; /* Overlay number, 0x0. */
145 char e_res[4][2]; /* Reserved words, all 0x0. */
146 char e_oemid[2]; /* OEM identifier (for e_oeminfo), 0x0. */
147 char e_oeminfo[2]; /* OEM information; e_oemid specific, 0x0. */
148 char e_res2[10][2]; /* Reserved words, all 0x0. */
149 char e_lfanew[4]; /* File address of new exe header, usually 0x80. */
150 char dos_message[16][4]; /* Other stuff, always follow DOS header. */
151};
152
153struct external_PEI_IMAGE_hdr
154{
155 char nt_signature[4]; /* required NT signature, 0x4550. */
156
157 /* From standard header. */
158 char f_magic[2]; /* Magic number. */
159 char f_nscns[2]; /* Number of sections. */
160 char f_timdat[4]; /* Time & date stamp. */
161 char f_symptr[4]; /* File pointer to symtab. */
162 char f_nsyms[4]; /* Number of symtab entries. */
163 char f_opthdr[2]; /* Sizeof(optional hdr). */
164 char f_flags[2]; /* Flags. */
165};
166
167struct external_PEI_filehdr
168{
169 /* DOS header fields - always at offset zero in the EXE file. */
170 char e_magic[2]; /* Magic number, 0x5a4d. */
171 char e_cblp[2]; /* Bytes on last page of file, 0x90. */
172 char e_cp[2]; /* Pages in file, 0x3. */
173 char e_crlc[2]; /* Relocations, 0x0. */
174 char e_cparhdr[2]; /* Size of header in paragraphs, 0x4. */
175 char e_minalloc[2]; /* Minimum extra paragraphs needed, 0x0. */
176 char e_maxalloc[2]; /* Maximum extra paragraphs needed, 0xFFFF. */
177 char e_ss[2]; /* Initial (relative) SS value, 0x0. */
178 char e_sp[2]; /* Initial SP value, 0xb8. */
179 char e_csum[2]; /* Checksum, 0x0. */
180 char e_ip[2]; /* Initial IP value, 0x0. */
181 char e_cs[2]; /* Initial (relative) CS value, 0x0. */
182 char e_lfarlc[2]; /* File address of relocation table, 0x40. */
183 char e_ovno[2]; /* Overlay number, 0x0. */
184 char e_res[4][2]; /* Reserved words, all 0x0. */
185 char e_oemid[2]; /* OEM identifier (for e_oeminfo), 0x0. */
186 char e_oeminfo[2]; /* OEM information; e_oemid specific, 0x0. */
187 char e_res2[10][2]; /* Reserved words, all 0x0. */
188 char e_lfanew[4]; /* File address of new exe header, usually 0x80. */
189 char dos_message[16][4]; /* Other stuff, always follow DOS header. */
190
191 /* Note: additional bytes may be inserted before the signature. Use
192 the e_lfanew field to find the actual location of the NT signature. */
193
194 char nt_signature[4]; /* required NT signature, 0x4550. */
195
196 /* From standard header. */
197 char f_magic[2]; /* Magic number. */
198 char f_nscns[2]; /* Number of sections. */
199 char f_timdat[4]; /* Time & date stamp. */
200 char f_symptr[4]; /* File pointer to symtab. */
201 char f_nsyms[4]; /* Number of symtab entries. */
202 char f_opthdr[2]; /* Sizeof(optional hdr). */
203 char f_flags[2]; /* Flags. */
204};
205
206#ifdef COFF_IMAGE_WITH_PE
207
208/* The filehdr is only weird in images. */
209
210#undef FILHDR
211#define FILHDR struct external_PEI_filehdr
212#undef FILHSZ
213#define FILHSZ 152
214
215#endif /* COFF_IMAGE_WITH_PE */
216
217/* 32-bit PE a.out header: */
218
219typedef struct
220{
221 AOUTHDR standard;
222
223 /* NT extra fields; see internal.h for descriptions. */
224 char ImageBase[4];
225 char SectionAlignment[4];
226 char FileAlignment[4];
227 char MajorOperatingSystemVersion[2];
228 char MinorOperatingSystemVersion[2];
229 char MajorImageVersion[2];
230 char MinorImageVersion[2];
231 char MajorSubsystemVersion[2];
232 char MinorSubsystemVersion[2];
233 char Reserved1[4];
234 char SizeOfImage[4];
235 char SizeOfHeaders[4];
236 char CheckSum[4];
237 char Subsystem[2];
238 char DllCharacteristics[2];
239 char SizeOfStackReserve[4];
240 char SizeOfStackCommit[4];
241 char SizeOfHeapReserve[4];
242 char SizeOfHeapCommit[4];
243 char LoaderFlags[4];
244 char NumberOfRvaAndSizes[4];
245 /* IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; */
246 char DataDirectory[16][2][4]; /* 16 entries, 2 elements/entry, 4 chars. */
247} PEAOUTHDR;
248#undef AOUTSZ
249#define AOUTSZ (AOUTHDRSZ + 196)
250
251/* Like PEAOUTHDR, except that the "standard" member has no BaseOfData
252 (aka data_start) member and that some of the members are 8 instead
253 of just 4 bytes long. */
254typedef struct
255{
256 AOUTHDR standard;
257
258 /* NT extra fields; see internal.h for descriptions. */
259 char ImageBase[8];
260 char SectionAlignment[4];
261 char FileAlignment[4];
262 char MajorOperatingSystemVersion[2];
263 char MinorOperatingSystemVersion[2];
264 char MajorImageVersion[2];
265 char MinorImageVersion[2];
266 char MajorSubsystemVersion[2];
267 char MinorSubsystemVersion[2];
268 char Reserved1[4];
269 char SizeOfImage[4];
270 char SizeOfHeaders[4];
271 char CheckSum[4];
272 char Subsystem[2];
273 char DllCharacteristics[2];
274 char SizeOfStackReserve[8];
275 char SizeOfStackCommit[8];
276 char SizeOfHeapReserve[8];
277 char SizeOfHeapCommit[8];
278 char LoaderFlags[4];
279 char NumberOfRvaAndSizes[4];
280 /* IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; */
281 char DataDirectory[16][2][4]; /* 16 entries, 2 elements/entry, 4 chars. */
282} PEPAOUTHDR;
283#define PEPAOUTSZ 240
284
285#undef E_FILNMLEN
286#define E_FILNMLEN 18 /* # characters in a file name. */
287
288/* Import Tyoes fot ILF format object files.. */
289#define IMPORT_CODE 0
290#define IMPORT_DATA 1
291#define IMPORT_CONST 2
292
293/* Import Name Tyoes for ILF format object files. */
294#define IMPORT_ORDINAL 0
295#define IMPORT_NAME 1
296#define IMPORT_NAME_NOPREFIX 2
297#define IMPORT_NAME_UNDECORATE 3
298
299#endif /* _PE_H */
Note: See TracBrowser for help on using the repository browser.