1 //===-- ObjectFilePECOFF.h --------------------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #ifndef liblldb_ObjectFilePECOFF_h_
11 #define liblldb_ObjectFilePECOFF_h_
12 
13 // C Includes
14 // C++ Includes
15 #include <vector>
16 
17 // Other libraries and framework includes
18 // Project includes
19 #include "lldb/Symbol/ObjectFile.h"
20 
21 class ObjectFilePECOFF :
22     public lldb_private::ObjectFile
23 {
24 public:
25     typedef enum MachineType
26     {
27         MachineUnknown = 0x0,
28         MachineAm33 = 0x1d3,
29         MachineAmd64 = 0x8664,
30         MachineArm = 0x1c0,
31         MachineArmNt = 0x1c4,
32         MachineArm64 = 0xaa64,
33         MachineEbc = 0xebc,
34         MachineX86 = 0x14c,
35         MachineIA64 = 0x200,
36         MachineM32R = 0x9041,
37         MachineMips16 = 0x266,
38         MachineMipsFpu = 0x366,
39         MachineMipsFpu16 = 0x466,
40         MachinePowerPc = 0x1f0,
41         MachinePowerPcfp = 0x1f1,
42         MachineR4000 = 0x166,
43         MachineSh3 = 0x1a2,
44         MachineSh3dsp = 0x1a3,
45         MachineSh4 = 0x1a6,
46         MachineSh5 = 0x1a8,
47         MachineThumb = 0x1c2,
48         MachineWcemIpsv2 = 0x169
49     } MachineType;
50 
51     ObjectFilePECOFF(const lldb::ModuleSP &module_sp,
52                      lldb::DataBufferSP& data_sp,
53                      lldb::offset_t data_offset,
54                      const lldb_private::FileSpec* file,
55                      lldb::offset_t file_offset,
56                      lldb::offset_t length);
57 
58     ~ObjectFilePECOFF() override;
59 
60     //------------------------------------------------------------------
61     // Static Functions
62     //------------------------------------------------------------------
63     static void
64     Initialize();
65 
66     static void
67     Terminate();
68 
69     static lldb_private::ConstString
70     GetPluginNameStatic();
71 
72     static const char *
73     GetPluginDescriptionStatic();
74 
75     static ObjectFile *
76     CreateInstance (const lldb::ModuleSP &module_sp,
77                     lldb::DataBufferSP& data_sp,
78                     lldb::offset_t data_offset,
79                     const lldb_private::FileSpec* file,
80                     lldb::offset_t offset,
81                     lldb::offset_t length);
82 
83     static lldb_private::ObjectFile *
84     CreateMemoryInstance (const lldb::ModuleSP &module_sp,
85                           lldb::DataBufferSP& data_sp,
86                           const lldb::ProcessSP &process_sp,
87                           lldb::addr_t header_addr);
88 
89     static size_t
90     GetModuleSpecifications (const lldb_private::FileSpec& file,
91                              lldb::DataBufferSP& data_sp,
92                              lldb::offset_t data_offset,
93                              lldb::offset_t file_offset,
94                              lldb::offset_t length,
95                              lldb_private::ModuleSpecList &specs);
96 
97     static bool
98     SaveCore (const lldb::ProcessSP &process_sp,
99               const lldb_private::FileSpec &outfile,
100               lldb_private::Error &error);
101 
102     static bool
103     MagicBytesMatch (lldb::DataBufferSP& data_sp);
104 
105     bool
106     ParseHeader() override;
107 
108     bool
109     SetLoadAddress(lldb_private::Target &target, lldb::addr_t value, bool value_is_offset) override;
110 
111     lldb::ByteOrder
112     GetByteOrder() const override;
113 
114     bool
115     IsExecutable() const override;
116 
117     uint32_t
118     GetAddressByteSize() const override;
119 
120 //    virtual lldb_private::AddressClass
121 //    GetAddressClass (lldb::addr_t file_addr);
122 
123     lldb_private::Symtab *
124     GetSymtab() override;
125 
126     bool
127     IsStripped() override;
128 
129     void
130     CreateSections(lldb_private::SectionList &unified_section_list) override;
131 
132     void
133     Dump(lldb_private::Stream *s) override;
134 
135     bool
136     GetArchitecture(lldb_private::ArchSpec &arch) override;
137 
138     bool
139     GetUUID(lldb_private::UUID* uuid) override;
140 
141     uint32_t
142     GetDependentModules(lldb_private::FileSpecList& files) override;
143 
144 //    virtual lldb_private::Address
145 //    GetEntryPointAddress ();
146 
147     ObjectFile::Type
148     CalculateType() override;
149 
150     ObjectFile::Strata
151     CalculateStrata() override;
152 
153     //------------------------------------------------------------------
154     // PluginInterface protocol
155     //------------------------------------------------------------------
156     lldb_private::ConstString
157     GetPluginName() override;
158 
159     uint32_t
160     GetPluginVersion() override;
161 
162 protected:
163 	bool NeedsEndianSwap() const;
164 
165 	typedef struct dos_header  {  // DOS .EXE header
166 		uint16_t e_magic;         // Magic number
167 		uint16_t e_cblp;          // Bytes on last page of file
168 		uint16_t e_cp;            // Pages in file
169 		uint16_t e_crlc;          // Relocations
170 		uint16_t e_cparhdr;       // Size of header in paragraphs
171 		uint16_t e_minalloc;      // Minimum extra paragraphs needed
172 		uint16_t e_maxalloc;      // Maximum extra paragraphs needed
173 		uint16_t e_ss;            // Initial (relative) SS value
174 		uint16_t e_sp;            // Initial SP value
175 		uint16_t e_csum;          // Checksum
176 		uint16_t e_ip;            // Initial IP value
177 		uint16_t e_cs;            // Initial (relative) CS value
178 		uint16_t e_lfarlc;        // File address of relocation table
179 		uint16_t e_ovno;          // Overlay number
180 		uint16_t e_res[4];        // Reserved words
181 		uint16_t e_oemid;         // OEM identifier (for e_oeminfo)
182 		uint16_t e_oeminfo;       // OEM information; e_oemid specific
183 		uint16_t e_res2[10];      // Reserved words
184 		uint32_t e_lfanew;        // File address of new exe header
185     } dos_header_t;
186 
187 	typedef struct coff_header {
188 		uint16_t machine;
189 		uint16_t nsects;
190 		uint32_t modtime;
191 		uint32_t symoff;
192 		uint32_t nsyms;
193 		uint16_t hdrsize;
194 		uint16_t flags;
195 	} coff_header_t;
196 
197 	typedef struct data_directory {
198 		uint32_t vmaddr;
199 		uint32_t vmsize;
200 	} data_directory_t;
201 
202 	typedef struct coff_opt_header
203 	{
204 		uint16_t	magic;
205 		uint8_t		major_linker_version;
206 		uint8_t		minor_linker_version;
207 		uint32_t	code_size;
208 		uint32_t	data_size;
209 		uint32_t	bss_size;
210 		uint32_t	entry;
211 		uint32_t	code_offset;
212 		uint32_t	data_offset;
213 
214 		uint64_t	image_base;
215 		uint32_t	sect_alignment;
216 		uint32_t	file_alignment;
217 		uint16_t	major_os_system_version;
218 		uint16_t	minor_os_system_version;
219 		uint16_t	major_image_version;
220 		uint16_t	minor_image_version;
221 		uint16_t	major_subsystem_version;
222 		uint16_t	minor_subsystem_version;
223 		uint32_t	reserved1;
224 		uint32_t	image_size;
225 		uint32_t	header_size;
226 		uint32_t	checksum;
227 		uint16_t	subsystem;
228 		uint16_t	dll_flags;
229 		uint64_t	stack_reserve_size;
230 		uint64_t	stack_commit_size;
231 		uint64_t	heap_reserve_size;
232 		uint64_t	heap_commit_size;
233 		uint32_t	loader_flags;
234         //    uint32_t	num_data_dir_entries;
235 		std::vector<data_directory> data_dirs;	// will contain num_data_dir_entries entries
236 	} coff_opt_header_t;
237 
238     typedef enum coff_data_dir_type
239     {
240         coff_data_dir_export_table = 0,
241         coff_data_dir_import_table = 1,
242     } coff_data_dir_type;
243 
244 	typedef struct section_header {
245 		char		name[8];
246 		uint32_t	vmsize;	// Virtual Size
247 		uint32_t	vmaddr;	// Virtual Addr
248 		uint32_t	size;	// File size
249 		uint32_t	offset;	// File offset
250 		uint32_t	reloff;	// Offset to relocations
251 		uint32_t	lineoff;// Offset to line table entries
252 		uint16_t	nreloc;	// Number of relocation entries
253 		uint16_t	nline;	// Number of line table entries
254 		uint32_t	flags;
255 	} section_header_t;
256 
257 	typedef struct coff_symbol {
258 		char		name[8];
259 		uint32_t	value;
260 		uint16_t	sect;
261 		uint16_t	type;
262 		uint8_t		storage;
263 		uint8_t		naux;
264 	} coff_symbol_t;
265 
266     typedef struct export_directory_entry {
267         uint32_t   characteristics;
268         uint32_t   time_date_stamp;
269         uint16_t   major_version;
270         uint16_t   minor_version;
271         uint32_t   name;
272         uint32_t   base;
273         uint32_t   number_of_functions;
274         uint32_t   number_of_names;
275         uint32_t   address_of_functions;
276         uint32_t   address_of_names;
277         uint32_t   address_of_name_ordinals;
278     } export_directory_entry;
279 
280 	static bool ParseDOSHeader (lldb_private::DataExtractor &data, dos_header_t &dos_header);
281 	static bool ParseCOFFHeader (lldb_private::DataExtractor &data, lldb::offset_t *offset_ptr, coff_header_t &coff_header);
282 	bool ParseCOFFOptionalHeader (lldb::offset_t *offset_ptr);
283 	bool ParseSectionHeaders (uint32_t offset);
284 
285 	static	void DumpDOSHeader(lldb_private::Stream *s, const dos_header_t& header);
286 	static	void DumpCOFFHeader(lldb_private::Stream *s, const coff_header_t& header);
287 	static	void DumpOptCOFFHeader(lldb_private::Stream *s, const coff_opt_header_t& header);
288     void DumpSectionHeaders(lldb_private::Stream *s);
289     void DumpSectionHeader(lldb_private::Stream *s, const section_header_t& sh);
290     bool GetSectionName(std::string& sect_name, const section_header_t& sect);
291 
292 	typedef std::vector<section_header_t>		SectionHeaderColl;
293 	typedef SectionHeaderColl::iterator			SectionHeaderCollIter;
294 	typedef SectionHeaderColl::const_iterator	SectionHeaderCollConstIter;
295 private:
296 	dos_header_t		m_dos_header;
297 	coff_header_t		m_coff_header;
298 	coff_opt_header_t	m_coff_header_opt;
299 	SectionHeaderColl	m_sect_headers;
300     lldb::addr_t		m_image_base;
301 };
302 
303 #endif // liblldb_ObjectFilePECOFF_h_
304