1 //===-- ObjectFilePECOFF.cpp ----------------------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "ObjectFilePECOFF.h"
10 #include "PECallFrameInfo.h"
11 #include "WindowsMiniDump.h"
12 
13 #include "lldb/Core/FileSpecList.h"
14 #include "lldb/Core/Module.h"
15 #include "lldb/Core/ModuleSpec.h"
16 #include "lldb/Core/PluginManager.h"
17 #include "lldb/Core/Section.h"
18 #include "lldb/Core/StreamFile.h"
19 #include "lldb/Interpreter/OptionValueDictionary.h"
20 #include "lldb/Interpreter/OptionValueProperties.h"
21 #include "lldb/Symbol/ObjectFile.h"
22 #include "lldb/Target/Process.h"
23 #include "lldb/Target/SectionLoadList.h"
24 #include "lldb/Target/Target.h"
25 #include "lldb/Utility/ArchSpec.h"
26 #include "lldb/Utility/DataBufferHeap.h"
27 #include "lldb/Utility/FileSpec.h"
28 #include "lldb/Utility/LLDBLog.h"
29 #include "lldb/Utility/Log.h"
30 #include "lldb/Utility/StreamString.h"
31 #include "lldb/Utility/Timer.h"
32 #include "lldb/Utility/UUID.h"
33 
34 #include "llvm/BinaryFormat/COFF.h"
35 #include "llvm/Object/COFFImportFile.h"
36 #include "llvm/Support/CRC.h"
37 #include "llvm/Support/Error.h"
38 #include "llvm/Support/FormatAdapters.h"
39 #include "llvm/Support/Host.h"
40 #include "llvm/Support/MemoryBuffer.h"
41 #include <optional>
42 
43 #define IMAGE_DOS_SIGNATURE 0x5A4D    // MZ
44 #define IMAGE_NT_SIGNATURE 0x00004550 // PE00
45 #define OPT_HEADER_MAGIC_PE32 0x010b
46 #define OPT_HEADER_MAGIC_PE32_PLUS 0x020b
47 
48 using namespace lldb;
49 using namespace lldb_private;
50 
51 LLDB_PLUGIN_DEFINE(ObjectFilePECOFF)
52 
53 namespace {
54 
55 static constexpr OptionEnumValueElement g_abi_enums[] = {
56     {
57         llvm::Triple::UnknownEnvironment,
58         "default",
59         "Use default target (if it is Windows) or MSVC",
60     },
61     {
62         llvm::Triple::MSVC,
63         "msvc",
64         "MSVC ABI",
65     },
66     {
67         llvm::Triple::GNU,
68         "gnu",
69         "MinGW / Itanium ABI",
70     },
71 };
72 
73 #define LLDB_PROPERTIES_objectfilepecoff
74 #include "ObjectFilePECOFFProperties.inc"
75 
76 enum {
77 #define LLDB_PROPERTIES_objectfilepecoff
78 #include "ObjectFilePECOFFPropertiesEnum.inc"
79 };
80 
81 class PluginProperties : public Properties {
82 public:
GetSettingName()83   static ConstString GetSettingName() {
84     return ConstString(ObjectFilePECOFF::GetPluginNameStatic());
85   }
86 
PluginProperties()87   PluginProperties() {
88     m_collection_sp = std::make_shared<OptionValueProperties>(GetSettingName());
89     m_collection_sp->Initialize(g_objectfilepecoff_properties);
90   }
91 
ABI() const92   llvm::Triple::EnvironmentType ABI() const {
93     return (llvm::Triple::EnvironmentType)
94         m_collection_sp->GetPropertyAtIndexAsEnumeration(
95             nullptr, ePropertyABI, llvm::Triple::UnknownEnvironment);
96   }
97 
ModuleABIMap() const98   OptionValueDictionary *ModuleABIMap() const {
99     return m_collection_sp->GetPropertyAtIndexAsOptionValueDictionary(
100         nullptr, ePropertyModuleABIMap);
101   }
102 };
103 
104 } // namespace
105 
GetGlobalPluginProperties()106 static PluginProperties &GetGlobalPluginProperties() {
107   static PluginProperties g_settings;
108   return g_settings;
109 }
110 
GetDebugLinkContents(const llvm::object::COFFObjectFile & coff_obj,std::string & gnu_debuglink_file,uint32_t & gnu_debuglink_crc)111 static bool GetDebugLinkContents(const llvm::object::COFFObjectFile &coff_obj,
112                                  std::string &gnu_debuglink_file,
113                                  uint32_t &gnu_debuglink_crc) {
114   static ConstString g_sect_name_gnu_debuglink(".gnu_debuglink");
115   for (const auto &section : coff_obj.sections()) {
116     auto name = section.getName();
117     if (!name) {
118       llvm::consumeError(name.takeError());
119       continue;
120     }
121     if (*name == g_sect_name_gnu_debuglink.GetStringRef()) {
122       auto content = section.getContents();
123       if (!content) {
124         llvm::consumeError(content.takeError());
125         return false;
126       }
127       DataExtractor data(
128           content->data(), content->size(),
129           coff_obj.isLittleEndian() ? eByteOrderLittle : eByteOrderBig, 4);
130       lldb::offset_t gnu_debuglink_offset = 0;
131       gnu_debuglink_file = data.GetCStr(&gnu_debuglink_offset);
132       // Align to the next 4-byte offset
133       gnu_debuglink_offset = llvm::alignTo(gnu_debuglink_offset, 4);
134       data.GetU32(&gnu_debuglink_offset, &gnu_debuglink_crc, 1);
135       return true;
136     }
137   }
138   return false;
139 }
140 
GetCoffUUID(llvm::object::COFFObjectFile & coff_obj)141 static UUID GetCoffUUID(llvm::object::COFFObjectFile &coff_obj) {
142   const llvm::codeview::DebugInfo *pdb_info = nullptr;
143   llvm::StringRef pdb_file;
144 
145   // First, prefer to use the PDB build id. LLD generates this even for mingw
146   // targets without PDB output, and it does not get stripped either.
147   if (!coff_obj.getDebugPDBInfo(pdb_info, pdb_file) && pdb_info) {
148     if (pdb_info->PDB70.CVSignature == llvm::OMF::Signature::PDB70) {
149       UUID::CvRecordPdb70 info;
150       memcpy(&info.Uuid, pdb_info->PDB70.Signature, sizeof(info.Uuid));
151       info.Age = pdb_info->PDB70.Age;
152       return UUID(info);
153     }
154   }
155 
156   std::string gnu_debuglink_file;
157   uint32_t gnu_debuglink_crc;
158 
159   // The GNU linker normally does not write a PDB build id (unless requested
160   // with the --build-id option), so we should fall back to using the crc
161   // from .gnu_debuglink if it exists, just like how ObjectFileELF does it.
162   if (!GetDebugLinkContents(coff_obj, gnu_debuglink_file, gnu_debuglink_crc)) {
163     // If there is no .gnu_debuglink section, then this may be an object
164     // containing DWARF debug info for .gnu_debuglink, so calculate the crc of
165     // the object itself.
166     auto raw_data = coff_obj.getData();
167     LLDB_SCOPED_TIMERF(
168         "Calculating module crc32 %s with size %" PRIu64 " KiB",
169         FileSpec(coff_obj.getFileName()).GetLastPathComponent().AsCString(),
170         static_cast<lldb::offset_t>(raw_data.size()) / 1024);
171     gnu_debuglink_crc = llvm::crc32(0, llvm::arrayRefFromStringRef(raw_data));
172   }
173   // Use 4 bytes of crc from the .gnu_debuglink section.
174   llvm::support::ulittle32_t data(gnu_debuglink_crc);
175   return UUID(&data, sizeof(data));
176 }
177 
178 char ObjectFilePECOFF::ID;
179 
Initialize()180 void ObjectFilePECOFF::Initialize() {
181   PluginManager::RegisterPlugin(GetPluginNameStatic(),
182                                 GetPluginDescriptionStatic(), CreateInstance,
183                                 CreateMemoryInstance, GetModuleSpecifications,
184                                 SaveCore, DebuggerInitialize);
185 }
186 
DebuggerInitialize(Debugger & debugger)187 void ObjectFilePECOFF::DebuggerInitialize(Debugger &debugger) {
188   if (!PluginManager::GetSettingForObjectFilePlugin(
189           debugger, PluginProperties::GetSettingName())) {
190     const bool is_global_setting = true;
191     PluginManager::CreateSettingForObjectFilePlugin(
192         debugger, GetGlobalPluginProperties().GetValueProperties(),
193         ConstString("Properties for the PE/COFF object-file plug-in."),
194         is_global_setting);
195   }
196 }
197 
Terminate()198 void ObjectFilePECOFF::Terminate() {
199   PluginManager::UnregisterPlugin(CreateInstance);
200 }
201 
GetPluginDescriptionStatic()202 llvm::StringRef ObjectFilePECOFF::GetPluginDescriptionStatic() {
203   return "Portable Executable and Common Object File Format object file reader "
204          "(32 and 64 bit)";
205 }
206 
CreateInstance(const lldb::ModuleSP & module_sp,DataBufferSP data_sp,lldb::offset_t data_offset,const lldb_private::FileSpec * file_p,lldb::offset_t file_offset,lldb::offset_t length)207 ObjectFile *ObjectFilePECOFF::CreateInstance(
208     const lldb::ModuleSP &module_sp, DataBufferSP data_sp,
209     lldb::offset_t data_offset, const lldb_private::FileSpec *file_p,
210     lldb::offset_t file_offset, lldb::offset_t length) {
211   FileSpec file = file_p ? *file_p : FileSpec();
212   if (!data_sp) {
213     data_sp = MapFileData(file, length, file_offset);
214     if (!data_sp)
215       return nullptr;
216     data_offset = 0;
217   }
218 
219   if (!ObjectFilePECOFF::MagicBytesMatch(data_sp))
220     return nullptr;
221 
222   // Update the data to contain the entire file if it doesn't already
223   if (data_sp->GetByteSize() < length) {
224     data_sp = MapFileData(file, length, file_offset);
225     if (!data_sp)
226       return nullptr;
227   }
228 
229   auto objfile_up = std::make_unique<ObjectFilePECOFF>(
230       module_sp, data_sp, data_offset, file_p, file_offset, length);
231   if (!objfile_up || !objfile_up->ParseHeader())
232     return nullptr;
233 
234   // Cache coff binary.
235   if (!objfile_up->CreateBinary())
236     return nullptr;
237   return objfile_up.release();
238 }
239 
CreateMemoryInstance(const lldb::ModuleSP & module_sp,lldb::WritableDataBufferSP data_sp,const lldb::ProcessSP & process_sp,lldb::addr_t header_addr)240 ObjectFile *ObjectFilePECOFF::CreateMemoryInstance(
241     const lldb::ModuleSP &module_sp, lldb::WritableDataBufferSP data_sp,
242     const lldb::ProcessSP &process_sp, lldb::addr_t header_addr) {
243   if (!data_sp || !ObjectFilePECOFF::MagicBytesMatch(data_sp))
244     return nullptr;
245   auto objfile_up = std::make_unique<ObjectFilePECOFF>(
246       module_sp, data_sp, process_sp, header_addr);
247   if (objfile_up.get() && objfile_up->ParseHeader()) {
248     return objfile_up.release();
249   }
250   return nullptr;
251 }
252 
GetModuleSpecifications(const lldb_private::FileSpec & file,lldb::DataBufferSP & data_sp,lldb::offset_t data_offset,lldb::offset_t file_offset,lldb::offset_t length,lldb_private::ModuleSpecList & specs)253 size_t ObjectFilePECOFF::GetModuleSpecifications(
254     const lldb_private::FileSpec &file, lldb::DataBufferSP &data_sp,
255     lldb::offset_t data_offset, lldb::offset_t file_offset,
256     lldb::offset_t length, lldb_private::ModuleSpecList &specs) {
257   const size_t initial_count = specs.GetSize();
258   if (!data_sp || !ObjectFilePECOFF::MagicBytesMatch(data_sp))
259     return initial_count;
260 
261   Log *log = GetLog(LLDBLog::Object);
262 
263   if (data_sp->GetByteSize() < length)
264     if (DataBufferSP full_sp = MapFileData(file, -1, file_offset))
265       data_sp = std::move(full_sp);
266   auto binary = llvm::object::createBinary(llvm::MemoryBufferRef(
267       toStringRef(data_sp->GetData()), file.GetFilename().GetStringRef()));
268 
269   if (!binary) {
270     LLDB_LOG_ERROR(log, binary.takeError(),
271                    "Failed to create binary for file ({1}): {0}", file);
272     return initial_count;
273   }
274 
275   auto *COFFObj = llvm::dyn_cast<llvm::object::COFFObjectFile>(binary->get());
276   if (!COFFObj)
277     return initial_count;
278 
279   ModuleSpec module_spec(file);
280   ArchSpec &spec = module_spec.GetArchitecture();
281   lldb_private::UUID &uuid = module_spec.GetUUID();
282   if (!uuid.IsValid())
283     uuid = GetCoffUUID(*COFFObj);
284 
285   static llvm::Triple::EnvironmentType default_env = [] {
286     auto def_target = llvm::Triple(
287         llvm::Triple::normalize(llvm::sys::getDefaultTargetTriple()));
288     if (def_target.getOS() == llvm::Triple::Win32 &&
289         def_target.getEnvironment() != llvm::Triple::UnknownEnvironment)
290       return def_target.getEnvironment();
291     return llvm::Triple::MSVC;
292   }();
293 
294   // Check for a module-specific override.
295   OptionValueSP module_env_option;
296   const auto *map = GetGlobalPluginProperties().ModuleABIMap();
297   if (map->GetNumValues() > 0) {
298     // Step 1: Try with the exact file name.
299     auto name = file.GetLastPathComponent();
300     module_env_option = map->GetValueForKey(name);
301     if (!module_env_option) {
302       // Step 2: Try with the file name in lowercase.
303       auto name_lower = name.GetStringRef().lower();
304       module_env_option =
305           map->GetValueForKey(ConstString(llvm::StringRef(name_lower)));
306     }
307     if (!module_env_option) {
308       // Step 3: Try with the file name with ".debug" suffix stripped.
309       auto name_stripped = name.GetStringRef();
310       if (name_stripped.consume_back_insensitive(".debug")) {
311         module_env_option = map->GetValueForKey(ConstString(name_stripped));
312         if (!module_env_option) {
313           // Step 4: Try with the file name in lowercase with ".debug" suffix
314           // stripped.
315           auto name_lower = name_stripped.lower();
316           module_env_option =
317               map->GetValueForKey(ConstString(llvm::StringRef(name_lower)));
318         }
319       }
320     }
321   }
322   llvm::Triple::EnvironmentType env;
323   if (module_env_option)
324     env =
325         (llvm::Triple::EnvironmentType)module_env_option->GetEnumerationValue();
326   else
327     env = GetGlobalPluginProperties().ABI();
328 
329   if (env == llvm::Triple::UnknownEnvironment)
330     env = default_env;
331 
332   switch (COFFObj->getMachine()) {
333   case MachineAmd64:
334     spec.SetTriple("x86_64-pc-windows");
335     spec.GetTriple().setEnvironment(env);
336     specs.Append(module_spec);
337     break;
338   case MachineX86:
339     spec.SetTriple("i386-pc-windows");
340     spec.GetTriple().setEnvironment(env);
341     specs.Append(module_spec);
342     break;
343   case MachineArmNt:
344     spec.SetTriple("armv7-pc-windows");
345     spec.GetTriple().setEnvironment(env);
346     specs.Append(module_spec);
347     break;
348   case MachineArm64:
349     spec.SetTriple("aarch64-pc-windows");
350     spec.GetTriple().setEnvironment(env);
351     specs.Append(module_spec);
352     break;
353   default:
354     break;
355   }
356 
357   return specs.GetSize() - initial_count;
358 }
359 
SaveCore(const lldb::ProcessSP & process_sp,const lldb_private::FileSpec & outfile,lldb::SaveCoreStyle & core_style,lldb_private::Status & error)360 bool ObjectFilePECOFF::SaveCore(const lldb::ProcessSP &process_sp,
361                                 const lldb_private::FileSpec &outfile,
362                                 lldb::SaveCoreStyle &core_style,
363                                 lldb_private::Status &error) {
364   core_style = eSaveCoreFull;
365   return SaveMiniDump(process_sp, outfile, error);
366 }
367 
MagicBytesMatch(DataBufferSP data_sp)368 bool ObjectFilePECOFF::MagicBytesMatch(DataBufferSP data_sp) {
369   DataExtractor data(data_sp, eByteOrderLittle, 4);
370   lldb::offset_t offset = 0;
371   uint16_t magic = data.GetU16(&offset);
372   return magic == IMAGE_DOS_SIGNATURE;
373 }
374 
MapSymbolType(uint16_t coff_symbol_type)375 lldb::SymbolType ObjectFilePECOFF::MapSymbolType(uint16_t coff_symbol_type) {
376   // TODO:  We need to complete this mapping of COFF symbol types to LLDB ones.
377   // For now, here's a hack to make sure our function have types.
378   const auto complex_type =
379       coff_symbol_type >> llvm::COFF::SCT_COMPLEX_TYPE_SHIFT;
380   if (complex_type == llvm::COFF::IMAGE_SYM_DTYPE_FUNCTION) {
381     return lldb::eSymbolTypeCode;
382   }
383   const auto base_type = coff_symbol_type & 0xff;
384   if (base_type == llvm::COFF::IMAGE_SYM_TYPE_NULL &&
385       complex_type == llvm::COFF::IMAGE_SYM_DTYPE_NULL) {
386     // Unknown type. LLD and GNU ld uses this for variables on MinGW, so
387     // consider these symbols to be data to enable printing.
388     return lldb::eSymbolTypeData;
389   }
390   return lldb::eSymbolTypeInvalid;
391 }
392 
CreateBinary()393 bool ObjectFilePECOFF::CreateBinary() {
394   if (m_binary)
395     return true;
396 
397   Log *log = GetLog(LLDBLog::Object);
398 
399   auto binary = llvm::object::createBinary(llvm::MemoryBufferRef(
400       toStringRef(m_data.GetData()), m_file.GetFilename().GetStringRef()));
401   if (!binary) {
402     LLDB_LOG_ERROR(log, binary.takeError(),
403                    "Failed to create binary for file ({1}): {0}", m_file);
404     return false;
405   }
406 
407   // Make sure we only handle COFF format.
408   m_binary =
409       llvm::unique_dyn_cast<llvm::object::COFFObjectFile>(std::move(*binary));
410   if (!m_binary)
411     return false;
412 
413   LLDB_LOG(log, "this = {0}, module = {1} ({2}), file = {3}, binary = {4}",
414            this, GetModule().get(), GetModule()->GetSpecificationDescription(),
415            m_file.GetPath(), m_binary.get());
416   return true;
417 }
418 
ObjectFilePECOFF(const lldb::ModuleSP & module_sp,DataBufferSP data_sp,lldb::offset_t data_offset,const FileSpec * file,lldb::offset_t file_offset,lldb::offset_t length)419 ObjectFilePECOFF::ObjectFilePECOFF(const lldb::ModuleSP &module_sp,
420                                    DataBufferSP data_sp,
421                                    lldb::offset_t data_offset,
422                                    const FileSpec *file,
423                                    lldb::offset_t file_offset,
424                                    lldb::offset_t length)
425     : ObjectFile(module_sp, file, file_offset, length, data_sp, data_offset),
426       m_dos_header(), m_coff_header(), m_coff_header_opt(), m_sect_headers(),
427       m_image_base(LLDB_INVALID_ADDRESS), m_entry_point_address(),
428       m_deps_filespec() {}
429 
ObjectFilePECOFF(const lldb::ModuleSP & module_sp,WritableDataBufferSP header_data_sp,const lldb::ProcessSP & process_sp,addr_t header_addr)430 ObjectFilePECOFF::ObjectFilePECOFF(const lldb::ModuleSP &module_sp,
431                                    WritableDataBufferSP header_data_sp,
432                                    const lldb::ProcessSP &process_sp,
433                                    addr_t header_addr)
434     : ObjectFile(module_sp, process_sp, header_addr, header_data_sp),
435       m_dos_header(), m_coff_header(), m_coff_header_opt(), m_sect_headers(),
436       m_image_base(LLDB_INVALID_ADDRESS), m_entry_point_address(),
437       m_deps_filespec() {}
438 
439 ObjectFilePECOFF::~ObjectFilePECOFF() = default;
440 
ParseHeader()441 bool ObjectFilePECOFF::ParseHeader() {
442   ModuleSP module_sp(GetModule());
443   if (module_sp) {
444     std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
445     m_sect_headers.clear();
446     m_data.SetByteOrder(eByteOrderLittle);
447     lldb::offset_t offset = 0;
448 
449     if (ParseDOSHeader(m_data, m_dos_header)) {
450       offset = m_dos_header.e_lfanew;
451       uint32_t pe_signature = m_data.GetU32(&offset);
452       if (pe_signature != IMAGE_NT_SIGNATURE)
453         return false;
454       if (ParseCOFFHeader(m_data, &offset, m_coff_header)) {
455         if (m_coff_header.hdrsize > 0)
456           ParseCOFFOptionalHeader(&offset);
457         ParseSectionHeaders(offset);
458       }
459       m_data.SetAddressByteSize(GetAddressByteSize());
460       return true;
461     }
462   }
463   return false;
464 }
465 
SetLoadAddress(Target & target,addr_t value,bool value_is_offset)466 bool ObjectFilePECOFF::SetLoadAddress(Target &target, addr_t value,
467                                       bool value_is_offset) {
468   bool changed = false;
469   ModuleSP module_sp = GetModule();
470   if (module_sp) {
471     size_t num_loaded_sections = 0;
472     SectionList *section_list = GetSectionList();
473     if (section_list) {
474       if (!value_is_offset) {
475         value -= m_image_base;
476       }
477 
478       const size_t num_sections = section_list->GetSize();
479       size_t sect_idx = 0;
480 
481       for (sect_idx = 0; sect_idx < num_sections; ++sect_idx) {
482         // Iterate through the object file sections to find all of the sections
483         // that have SHF_ALLOC in their flag bits.
484         SectionSP section_sp(section_list->GetSectionAtIndex(sect_idx));
485         if (section_sp && !section_sp->IsThreadSpecific()) {
486           if (target.GetSectionLoadList().SetSectionLoadAddress(
487                   section_sp, section_sp->GetFileAddress() + value))
488             ++num_loaded_sections;
489         }
490       }
491       changed = num_loaded_sections > 0;
492     }
493   }
494   return changed;
495 }
496 
GetByteOrder() const497 ByteOrder ObjectFilePECOFF::GetByteOrder() const { return eByteOrderLittle; }
498 
IsExecutable() const499 bool ObjectFilePECOFF::IsExecutable() const {
500   return (m_coff_header.flags & llvm::COFF::IMAGE_FILE_DLL) == 0;
501 }
502 
GetAddressByteSize() const503 uint32_t ObjectFilePECOFF::GetAddressByteSize() const {
504   if (m_coff_header_opt.magic == OPT_HEADER_MAGIC_PE32_PLUS)
505     return 8;
506   else if (m_coff_header_opt.magic == OPT_HEADER_MAGIC_PE32)
507     return 4;
508   return 4;
509 }
510 
511 // NeedsEndianSwap
512 //
513 // Return true if an endian swap needs to occur when extracting data from this
514 // file.
NeedsEndianSwap() const515 bool ObjectFilePECOFF::NeedsEndianSwap() const {
516 #if defined(__LITTLE_ENDIAN__)
517   return false;
518 #else
519   return true;
520 #endif
521 }
522 // ParseDOSHeader
ParseDOSHeader(DataExtractor & data,dos_header_t & dos_header)523 bool ObjectFilePECOFF::ParseDOSHeader(DataExtractor &data,
524                                       dos_header_t &dos_header) {
525   bool success = false;
526   lldb::offset_t offset = 0;
527   success = data.ValidOffsetForDataOfSize(0, sizeof(dos_header));
528 
529   if (success) {
530     dos_header.e_magic = data.GetU16(&offset); // Magic number
531     success = dos_header.e_magic == IMAGE_DOS_SIGNATURE;
532 
533     if (success) {
534       dos_header.e_cblp = data.GetU16(&offset); // Bytes on last page of file
535       dos_header.e_cp = data.GetU16(&offset);   // Pages in file
536       dos_header.e_crlc = data.GetU16(&offset); // Relocations
537       dos_header.e_cparhdr =
538           data.GetU16(&offset); // Size of header in paragraphs
539       dos_header.e_minalloc =
540           data.GetU16(&offset); // Minimum extra paragraphs needed
541       dos_header.e_maxalloc =
542           data.GetU16(&offset);               // Maximum extra paragraphs needed
543       dos_header.e_ss = data.GetU16(&offset); // Initial (relative) SS value
544       dos_header.e_sp = data.GetU16(&offset); // Initial SP value
545       dos_header.e_csum = data.GetU16(&offset); // Checksum
546       dos_header.e_ip = data.GetU16(&offset);   // Initial IP value
547       dos_header.e_cs = data.GetU16(&offset);   // Initial (relative) CS value
548       dos_header.e_lfarlc =
549           data.GetU16(&offset); // File address of relocation table
550       dos_header.e_ovno = data.GetU16(&offset); // Overlay number
551 
552       dos_header.e_res[0] = data.GetU16(&offset); // Reserved words
553       dos_header.e_res[1] = data.GetU16(&offset); // Reserved words
554       dos_header.e_res[2] = data.GetU16(&offset); // Reserved words
555       dos_header.e_res[3] = data.GetU16(&offset); // Reserved words
556 
557       dos_header.e_oemid =
558           data.GetU16(&offset); // OEM identifier (for e_oeminfo)
559       dos_header.e_oeminfo =
560           data.GetU16(&offset); // OEM information; e_oemid specific
561       dos_header.e_res2[0] = data.GetU16(&offset); // Reserved words
562       dos_header.e_res2[1] = data.GetU16(&offset); // Reserved words
563       dos_header.e_res2[2] = data.GetU16(&offset); // Reserved words
564       dos_header.e_res2[3] = data.GetU16(&offset); // Reserved words
565       dos_header.e_res2[4] = data.GetU16(&offset); // Reserved words
566       dos_header.e_res2[5] = data.GetU16(&offset); // Reserved words
567       dos_header.e_res2[6] = data.GetU16(&offset); // Reserved words
568       dos_header.e_res2[7] = data.GetU16(&offset); // Reserved words
569       dos_header.e_res2[8] = data.GetU16(&offset); // Reserved words
570       dos_header.e_res2[9] = data.GetU16(&offset); // Reserved words
571 
572       dos_header.e_lfanew =
573           data.GetU32(&offset); // File address of new exe header
574     }
575   }
576   if (!success)
577     memset(&dos_header, 0, sizeof(dos_header));
578   return success;
579 }
580 
581 // ParserCOFFHeader
ParseCOFFHeader(DataExtractor & data,lldb::offset_t * offset_ptr,coff_header_t & coff_header)582 bool ObjectFilePECOFF::ParseCOFFHeader(DataExtractor &data,
583                                        lldb::offset_t *offset_ptr,
584                                        coff_header_t &coff_header) {
585   bool success =
586       data.ValidOffsetForDataOfSize(*offset_ptr, sizeof(coff_header));
587   if (success) {
588     coff_header.machine = data.GetU16(offset_ptr);
589     coff_header.nsects = data.GetU16(offset_ptr);
590     coff_header.modtime = data.GetU32(offset_ptr);
591     coff_header.symoff = data.GetU32(offset_ptr);
592     coff_header.nsyms = data.GetU32(offset_ptr);
593     coff_header.hdrsize = data.GetU16(offset_ptr);
594     coff_header.flags = data.GetU16(offset_ptr);
595   }
596   if (!success)
597     memset(&coff_header, 0, sizeof(coff_header));
598   return success;
599 }
600 
ParseCOFFOptionalHeader(lldb::offset_t * offset_ptr)601 bool ObjectFilePECOFF::ParseCOFFOptionalHeader(lldb::offset_t *offset_ptr) {
602   bool success = false;
603   const lldb::offset_t end_offset = *offset_ptr + m_coff_header.hdrsize;
604   if (*offset_ptr < end_offset) {
605     success = true;
606     m_coff_header_opt.magic = m_data.GetU16(offset_ptr);
607     m_coff_header_opt.major_linker_version = m_data.GetU8(offset_ptr);
608     m_coff_header_opt.minor_linker_version = m_data.GetU8(offset_ptr);
609     m_coff_header_opt.code_size = m_data.GetU32(offset_ptr);
610     m_coff_header_opt.data_size = m_data.GetU32(offset_ptr);
611     m_coff_header_opt.bss_size = m_data.GetU32(offset_ptr);
612     m_coff_header_opt.entry = m_data.GetU32(offset_ptr);
613     m_coff_header_opt.code_offset = m_data.GetU32(offset_ptr);
614 
615     const uint32_t addr_byte_size = GetAddressByteSize();
616 
617     if (*offset_ptr < end_offset) {
618       if (m_coff_header_opt.magic == OPT_HEADER_MAGIC_PE32) {
619         // PE32 only
620         m_coff_header_opt.data_offset = m_data.GetU32(offset_ptr);
621       } else
622         m_coff_header_opt.data_offset = 0;
623 
624       if (*offset_ptr < end_offset) {
625         m_coff_header_opt.image_base =
626             m_data.GetMaxU64(offset_ptr, addr_byte_size);
627         m_coff_header_opt.sect_alignment = m_data.GetU32(offset_ptr);
628         m_coff_header_opt.file_alignment = m_data.GetU32(offset_ptr);
629         m_coff_header_opt.major_os_system_version = m_data.GetU16(offset_ptr);
630         m_coff_header_opt.minor_os_system_version = m_data.GetU16(offset_ptr);
631         m_coff_header_opt.major_image_version = m_data.GetU16(offset_ptr);
632         m_coff_header_opt.minor_image_version = m_data.GetU16(offset_ptr);
633         m_coff_header_opt.major_subsystem_version = m_data.GetU16(offset_ptr);
634         m_coff_header_opt.minor_subsystem_version = m_data.GetU16(offset_ptr);
635         m_coff_header_opt.reserved1 = m_data.GetU32(offset_ptr);
636         m_coff_header_opt.image_size = m_data.GetU32(offset_ptr);
637         m_coff_header_opt.header_size = m_data.GetU32(offset_ptr);
638         m_coff_header_opt.checksum = m_data.GetU32(offset_ptr);
639         m_coff_header_opt.subsystem = m_data.GetU16(offset_ptr);
640         m_coff_header_opt.dll_flags = m_data.GetU16(offset_ptr);
641         m_coff_header_opt.stack_reserve_size =
642             m_data.GetMaxU64(offset_ptr, addr_byte_size);
643         m_coff_header_opt.stack_commit_size =
644             m_data.GetMaxU64(offset_ptr, addr_byte_size);
645         m_coff_header_opt.heap_reserve_size =
646             m_data.GetMaxU64(offset_ptr, addr_byte_size);
647         m_coff_header_opt.heap_commit_size =
648             m_data.GetMaxU64(offset_ptr, addr_byte_size);
649         m_coff_header_opt.loader_flags = m_data.GetU32(offset_ptr);
650         uint32_t num_data_dir_entries = m_data.GetU32(offset_ptr);
651         m_coff_header_opt.data_dirs.clear();
652         m_coff_header_opt.data_dirs.resize(num_data_dir_entries);
653         uint32_t i;
654         for (i = 0; i < num_data_dir_entries; i++) {
655           m_coff_header_opt.data_dirs[i].vmaddr = m_data.GetU32(offset_ptr);
656           m_coff_header_opt.data_dirs[i].vmsize = m_data.GetU32(offset_ptr);
657         }
658 
659         m_image_base = m_coff_header_opt.image_base;
660       }
661     }
662   }
663   // Make sure we are on track for section data which follows
664   *offset_ptr = end_offset;
665   return success;
666 }
667 
GetRVA(const Address & addr) const668 uint32_t ObjectFilePECOFF::GetRVA(const Address &addr) const {
669   return addr.GetFileAddress() - m_image_base;
670 }
671 
GetAddress(uint32_t rva)672 Address ObjectFilePECOFF::GetAddress(uint32_t rva) {
673   SectionList *sect_list = GetSectionList();
674   if (!sect_list)
675     return Address(GetFileAddress(rva));
676 
677   return Address(GetFileAddress(rva), sect_list);
678 }
679 
GetFileAddress(uint32_t rva) const680 lldb::addr_t ObjectFilePECOFF::GetFileAddress(uint32_t rva) const {
681   return m_image_base + rva;
682 }
683 
ReadImageData(uint32_t offset,size_t size)684 DataExtractor ObjectFilePECOFF::ReadImageData(uint32_t offset, size_t size) {
685   if (!size)
686     return {};
687 
688   if (m_data.ValidOffsetForDataOfSize(offset, size))
689     return DataExtractor(m_data, offset, size);
690 
691   ProcessSP process_sp(m_process_wp.lock());
692   DataExtractor data;
693   if (process_sp) {
694     auto data_up = std::make_unique<DataBufferHeap>(size, 0);
695     Status readmem_error;
696     size_t bytes_read =
697         process_sp->ReadMemory(m_image_base + offset, data_up->GetBytes(),
698                                data_up->GetByteSize(), readmem_error);
699     if (bytes_read == size) {
700       DataBufferSP buffer_sp(data_up.release());
701       data.SetData(buffer_sp, 0, buffer_sp->GetByteSize());
702     }
703   }
704   return data;
705 }
706 
ReadImageDataByRVA(uint32_t rva,size_t size)707 DataExtractor ObjectFilePECOFF::ReadImageDataByRVA(uint32_t rva, size_t size) {
708   Address addr = GetAddress(rva);
709   SectionSP sect = addr.GetSection();
710   if (!sect)
711     return {};
712   rva = sect->GetFileOffset() + addr.GetOffset();
713 
714   return ReadImageData(rva, size);
715 }
716 
717 // ParseSectionHeaders
ParseSectionHeaders(uint32_t section_header_data_offset)718 bool ObjectFilePECOFF::ParseSectionHeaders(
719     uint32_t section_header_data_offset) {
720   const uint32_t nsects = m_coff_header.nsects;
721   m_sect_headers.clear();
722 
723   if (nsects > 0) {
724     const size_t section_header_byte_size = nsects * sizeof(section_header_t);
725     DataExtractor section_header_data =
726         ReadImageData(section_header_data_offset, section_header_byte_size);
727 
728     lldb::offset_t offset = 0;
729     if (section_header_data.ValidOffsetForDataOfSize(
730             offset, section_header_byte_size)) {
731       m_sect_headers.resize(nsects);
732 
733       for (uint32_t idx = 0; idx < nsects; ++idx) {
734         const void *name_data = section_header_data.GetData(&offset, 8);
735         if (name_data) {
736           memcpy(m_sect_headers[idx].name, name_data, 8);
737           m_sect_headers[idx].vmsize = section_header_data.GetU32(&offset);
738           m_sect_headers[idx].vmaddr = section_header_data.GetU32(&offset);
739           m_sect_headers[idx].size = section_header_data.GetU32(&offset);
740           m_sect_headers[idx].offset = section_header_data.GetU32(&offset);
741           m_sect_headers[idx].reloff = section_header_data.GetU32(&offset);
742           m_sect_headers[idx].lineoff = section_header_data.GetU32(&offset);
743           m_sect_headers[idx].nreloc = section_header_data.GetU16(&offset);
744           m_sect_headers[idx].nline = section_header_data.GetU16(&offset);
745           m_sect_headers[idx].flags = section_header_data.GetU32(&offset);
746         }
747       }
748     }
749   }
750 
751   return !m_sect_headers.empty();
752 }
753 
GetSectionName(const section_header_t & sect)754 llvm::StringRef ObjectFilePECOFF::GetSectionName(const section_header_t &sect) {
755   llvm::StringRef hdr_name(sect.name, std::size(sect.name));
756   hdr_name = hdr_name.split('\0').first;
757   if (hdr_name.consume_front("/")) {
758     lldb::offset_t stroff;
759     if (!to_integer(hdr_name, stroff, 10))
760       return "";
761     lldb::offset_t string_file_offset =
762         m_coff_header.symoff + (m_coff_header.nsyms * 18) + stroff;
763     if (const char *name = m_data.GetCStr(&string_file_offset))
764       return name;
765     return "";
766   }
767   return hdr_name;
768 }
769 
ParseSymtab(Symtab & symtab)770 void ObjectFilePECOFF::ParseSymtab(Symtab &symtab) {
771   SectionList *sect_list = GetSectionList();
772   rva_symbol_list_t sorted_exports = AppendFromExportTable(sect_list, symtab);
773   AppendFromCOFFSymbolTable(sect_list, symtab, sorted_exports);
774 }
775 
RVASymbolListCompareRVA(const std::pair<uint32_t,uint32_t> & a,const std::pair<uint32_t,uint32_t> & b)776 static bool RVASymbolListCompareRVA(const std::pair<uint32_t, uint32_t> &a,
777                                     const std::pair<uint32_t, uint32_t> &b) {
778   return a.first < b.first;
779 }
780 
AppendFromCOFFSymbolTable(SectionList * sect_list,Symtab & symtab,const ObjectFilePECOFF::rva_symbol_list_t & sorted_exports)781 void ObjectFilePECOFF::AppendFromCOFFSymbolTable(
782     SectionList *sect_list, Symtab &symtab,
783     const ObjectFilePECOFF::rva_symbol_list_t &sorted_exports) {
784   const uint32_t num_syms = m_binary->getNumberOfSymbols();
785   if (num_syms == 0)
786     return;
787   // Check that this is not a bigobj; we do not support bigobj.
788   if (m_binary->getSymbolTableEntrySize() !=
789       sizeof(llvm::object::coff_symbol16))
790     return;
791 
792   Log *log = GetLog(LLDBLog::Object);
793   symtab.Reserve(symtab.GetNumSymbols() + num_syms);
794   for (const auto &sym_ref : m_binary->symbols()) {
795     const auto coff_sym_ref = m_binary->getCOFFSymbol(sym_ref);
796     auto name_or_error = sym_ref.getName();
797     if (auto err = name_or_error.takeError()) {
798       LLDB_LOG(log,
799                "ObjectFilePECOFF::AppendFromCOFFSymbolTable - failed to get "
800                "symbol table entry name: {0}",
801                llvm::fmt_consume(std::move(err)));
802       continue;
803     }
804     const llvm::StringRef sym_name = *name_or_error;
805     Symbol symbol;
806     symbol.GetMangled().SetValue(ConstString(sym_name));
807     int16_t section_number =
808         static_cast<int16_t>(coff_sym_ref.getSectionNumber());
809     if (section_number >= 1) {
810       symbol.GetAddressRef() = Address(
811           sect_list->FindSectionByID(section_number), coff_sym_ref.getValue());
812       const auto symbol_type = MapSymbolType(coff_sym_ref.getType());
813       symbol.SetType(symbol_type);
814 
815       // Check for duplicate of exported symbols:
816       const uint32_t symbol_rva = symbol.GetAddressRef().GetFileAddress() -
817                                   m_coff_header_opt.image_base;
818       const auto &first_match = std::lower_bound(
819           sorted_exports.begin(), sorted_exports.end(),
820           std::make_pair(symbol_rva, 0), RVASymbolListCompareRVA);
821       for (auto it = first_match;
822            it != sorted_exports.end() && it->first == symbol_rva; ++it) {
823         Symbol *exported = symtab.SymbolAtIndex(it->second);
824         if (symbol_type != lldb::eSymbolTypeInvalid)
825           exported->SetType(symbol_type);
826         if (exported->GetMangled() == symbol.GetMangled()) {
827           symbol.SetExternal(true);
828           // We don't want the symbol to be duplicated (e.g. when running
829           // `disas -n func`), but we also don't want to erase this entry (to
830           // preserve the original symbol order), so we mark it as additional.
831           symbol.SetType(lldb::eSymbolTypeAdditional);
832         } else {
833           // It is possible for a symbol to be exported in a different name
834           // from its original. In this case keep both entries so lookup using
835           // either names will work. If this symbol has an invalid type, replace
836           // it with the type from the export symbol.
837           if (symbol.GetType() == lldb::eSymbolTypeInvalid)
838             symbol.SetType(exported->GetType());
839         }
840       }
841     } else if (section_number == llvm::COFF::IMAGE_SYM_ABSOLUTE) {
842       symbol.GetAddressRef() = Address(coff_sym_ref.getValue());
843       symbol.SetType(lldb::eSymbolTypeAbsolute);
844     }
845     symtab.AddSymbol(symbol);
846   }
847 }
848 
849 ObjectFilePECOFF::rva_symbol_list_t
AppendFromExportTable(SectionList * sect_list,Symtab & symtab)850 ObjectFilePECOFF::AppendFromExportTable(SectionList *sect_list,
851                                         Symtab &symtab) {
852   const auto *export_table = m_binary->getExportTable();
853   if (!export_table)
854     return {};
855   const uint32_t num_syms = export_table->AddressTableEntries;
856   if (num_syms == 0)
857     return {};
858 
859   Log *log = GetLog(LLDBLog::Object);
860   rva_symbol_list_t export_list;
861   symtab.Reserve(symtab.GetNumSymbols() + num_syms);
862   // Read each export table entry, ordered by ordinal instead of by name.
863   for (const auto &entry : m_binary->export_directories()) {
864     llvm::StringRef sym_name;
865     if (auto err = entry.getSymbolName(sym_name)) {
866       LLDB_LOG(log,
867                "ObjectFilePECOFF::AppendFromExportTable - failed to get export "
868                "table entry name: {0}",
869                llvm::fmt_consume(std::move(err)));
870       continue;
871     }
872     Symbol symbol;
873     // Note: symbol name may be empty if it is only exported by ordinal.
874     symbol.GetMangled().SetValue(ConstString(sym_name));
875 
876     uint32_t ordinal;
877     llvm::cantFail(entry.getOrdinal(ordinal));
878     symbol.SetID(ordinal);
879 
880     bool is_forwarder;
881     llvm::cantFail(entry.isForwarder(is_forwarder));
882     if (is_forwarder) {
883       // Forwarder exports are redirected by the loader transparently, but keep
884       // it in symtab and make a note using the symbol name.
885       llvm::StringRef forwarder_name;
886       if (auto err = entry.getForwardTo(forwarder_name)) {
887         LLDB_LOG(log,
888                  "ObjectFilePECOFF::AppendFromExportTable - failed to get "
889                  "forwarder name of forwarder export '{0}': {1}",
890                  sym_name, llvm::fmt_consume(std::move(err)));
891         continue;
892       }
893       llvm::SmallString<256> new_name = {symbol.GetDisplayName().GetStringRef(),
894                                          " (forwarded to ", forwarder_name,
895                                          ")"};
896       symbol.GetMangled().SetDemangledName(ConstString(new_name.str()));
897       symbol.SetDemangledNameIsSynthesized(true);
898     }
899 
900     uint32_t function_rva;
901     if (auto err = entry.getExportRVA(function_rva)) {
902       LLDB_LOG(log,
903                "ObjectFilePECOFF::AppendFromExportTable - failed to get "
904                "address of export entry '{0}': {1}",
905                sym_name, llvm::fmt_consume(std::move(err)));
906       continue;
907     }
908     // Skip the symbol if it doesn't look valid.
909     if (function_rva == 0 && sym_name.empty())
910       continue;
911     symbol.GetAddressRef() =
912         Address(m_coff_header_opt.image_base + function_rva, sect_list);
913 
914     // An exported symbol may be either code or data. Guess by checking whether
915     // the section containing the symbol is executable.
916     symbol.SetType(lldb::eSymbolTypeData);
917     if (!is_forwarder)
918       if (auto section_sp = symbol.GetAddressRef().GetSection())
919         if (section_sp->GetPermissions() & ePermissionsExecutable)
920           symbol.SetType(lldb::eSymbolTypeCode);
921     symbol.SetExternal(true);
922     uint32_t idx = symtab.AddSymbol(symbol);
923     export_list.push_back(std::make_pair(function_rva, idx));
924   }
925   std::stable_sort(export_list.begin(), export_list.end(),
926                    RVASymbolListCompareRVA);
927   return export_list;
928 }
929 
CreateCallFrameInfo()930 std::unique_ptr<CallFrameInfo> ObjectFilePECOFF::CreateCallFrameInfo() {
931   if (llvm::COFF::EXCEPTION_TABLE >= m_coff_header_opt.data_dirs.size())
932     return {};
933 
934   data_directory data_dir_exception =
935       m_coff_header_opt.data_dirs[llvm::COFF::EXCEPTION_TABLE];
936   if (!data_dir_exception.vmaddr)
937     return {};
938 
939   if (m_coff_header.machine != llvm::COFF::IMAGE_FILE_MACHINE_AMD64)
940     return {};
941 
942   return std::make_unique<PECallFrameInfo>(*this, data_dir_exception.vmaddr,
943                                            data_dir_exception.vmsize);
944 }
945 
IsStripped()946 bool ObjectFilePECOFF::IsStripped() {
947   // TODO: determine this for COFF
948   return false;
949 }
950 
GetSectionType(llvm::StringRef sect_name,const section_header_t & sect)951 SectionType ObjectFilePECOFF::GetSectionType(llvm::StringRef sect_name,
952                                              const section_header_t &sect) {
953   ConstString const_sect_name(sect_name);
954   static ConstString g_code_sect_name(".code");
955   static ConstString g_CODE_sect_name("CODE");
956   static ConstString g_data_sect_name(".data");
957   static ConstString g_DATA_sect_name("DATA");
958   static ConstString g_bss_sect_name(".bss");
959   static ConstString g_BSS_sect_name("BSS");
960 
961   if (sect.flags & llvm::COFF::IMAGE_SCN_CNT_CODE &&
962       ((const_sect_name == g_code_sect_name) ||
963        (const_sect_name == g_CODE_sect_name))) {
964     return eSectionTypeCode;
965   }
966   if (sect.flags & llvm::COFF::IMAGE_SCN_CNT_INITIALIZED_DATA &&
967              ((const_sect_name == g_data_sect_name) ||
968               (const_sect_name == g_DATA_sect_name))) {
969     if (sect.size == 0 && sect.offset == 0)
970       return eSectionTypeZeroFill;
971     else
972       return eSectionTypeData;
973   }
974   if (sect.flags & llvm::COFF::IMAGE_SCN_CNT_UNINITIALIZED_DATA &&
975              ((const_sect_name == g_bss_sect_name) ||
976               (const_sect_name == g_BSS_sect_name))) {
977     if (sect.size == 0)
978       return eSectionTypeZeroFill;
979     else
980       return eSectionTypeData;
981   }
982 
983   SectionType section_type =
984       llvm::StringSwitch<SectionType>(sect_name)
985           .Case(".debug", eSectionTypeDebug)
986           .Case(".stabstr", eSectionTypeDataCString)
987           .Case(".reloc", eSectionTypeOther)
988           .Case(".debug_abbrev", eSectionTypeDWARFDebugAbbrev)
989           .Case(".debug_aranges", eSectionTypeDWARFDebugAranges)
990           .Case(".debug_frame", eSectionTypeDWARFDebugFrame)
991           .Case(".debug_info", eSectionTypeDWARFDebugInfo)
992           .Case(".debug_line", eSectionTypeDWARFDebugLine)
993           .Case(".debug_loc", eSectionTypeDWARFDebugLoc)
994           .Case(".debug_loclists", eSectionTypeDWARFDebugLocLists)
995           .Case(".debug_macinfo", eSectionTypeDWARFDebugMacInfo)
996           .Case(".debug_names", eSectionTypeDWARFDebugNames)
997           .Case(".debug_pubnames", eSectionTypeDWARFDebugPubNames)
998           .Case(".debug_pubtypes", eSectionTypeDWARFDebugPubTypes)
999           .Case(".debug_ranges", eSectionTypeDWARFDebugRanges)
1000           .Case(".debug_str", eSectionTypeDWARFDebugStr)
1001           .Case(".debug_types", eSectionTypeDWARFDebugTypes)
1002           // .eh_frame can be truncated to 8 chars.
1003           .Cases(".eh_frame", ".eh_fram", eSectionTypeEHFrame)
1004           .Case(".gosymtab", eSectionTypeGoSymtab)
1005           .Default(eSectionTypeInvalid);
1006   if (section_type != eSectionTypeInvalid)
1007     return section_type;
1008 
1009   if (sect.flags & llvm::COFF::IMAGE_SCN_CNT_CODE)
1010     return eSectionTypeCode;
1011   if (sect.flags & llvm::COFF::IMAGE_SCN_CNT_INITIALIZED_DATA)
1012     return eSectionTypeData;
1013   if (sect.flags & llvm::COFF::IMAGE_SCN_CNT_UNINITIALIZED_DATA) {
1014     if (sect.size == 0)
1015       return eSectionTypeZeroFill;
1016     else
1017       return eSectionTypeData;
1018   }
1019   return eSectionTypeOther;
1020 }
1021 
CreateSections(SectionList & unified_section_list)1022 void ObjectFilePECOFF::CreateSections(SectionList &unified_section_list) {
1023   if (m_sections_up)
1024     return;
1025   m_sections_up = std::make_unique<SectionList>();
1026   ModuleSP module_sp(GetModule());
1027   if (module_sp) {
1028     std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
1029 
1030     SectionSP header_sp = std::make_shared<Section>(
1031         module_sp, this, ~user_id_t(0), ConstString("PECOFF header"),
1032         eSectionTypeOther, m_coff_header_opt.image_base,
1033         m_coff_header_opt.header_size,
1034         /*file_offset*/ 0, m_coff_header_opt.header_size,
1035         m_coff_header_opt.sect_alignment,
1036         /*flags*/ 0);
1037     header_sp->SetPermissions(ePermissionsReadable);
1038     m_sections_up->AddSection(header_sp);
1039     unified_section_list.AddSection(header_sp);
1040 
1041     const uint32_t nsects = m_sect_headers.size();
1042     ModuleSP module_sp(GetModule());
1043     for (uint32_t idx = 0; idx < nsects; ++idx) {
1044       llvm::StringRef sect_name = GetSectionName(m_sect_headers[idx]);
1045       ConstString const_sect_name(sect_name);
1046       SectionType section_type = GetSectionType(sect_name, m_sect_headers[idx]);
1047 
1048       SectionSP section_sp(new Section(
1049           module_sp,       // Module to which this section belongs
1050           this,            // Object file to which this section belongs
1051           idx + 1,         // Section ID is the 1 based section index.
1052           const_sect_name, // Name of this section
1053           section_type,
1054           m_coff_header_opt.image_base +
1055               m_sect_headers[idx].vmaddr, // File VM address == addresses as
1056                                           // they are found in the object file
1057           m_sect_headers[idx].vmsize,     // VM size in bytes of this section
1058           m_sect_headers[idx]
1059               .offset, // Offset to the data for this section in the file
1060           m_sect_headers[idx]
1061               .size, // Size in bytes of this section as found in the file
1062           m_coff_header_opt.sect_alignment, // Section alignment
1063           m_sect_headers[idx].flags));      // Flags for this section
1064 
1065       uint32_t permissions = 0;
1066       if (m_sect_headers[idx].flags & llvm::COFF::IMAGE_SCN_MEM_EXECUTE)
1067         permissions |= ePermissionsExecutable;
1068       if (m_sect_headers[idx].flags & llvm::COFF::IMAGE_SCN_MEM_READ)
1069         permissions |= ePermissionsReadable;
1070       if (m_sect_headers[idx].flags & llvm::COFF::IMAGE_SCN_MEM_WRITE)
1071         permissions |= ePermissionsWritable;
1072       section_sp->SetPermissions(permissions);
1073 
1074       m_sections_up->AddSection(section_sp);
1075       unified_section_list.AddSection(section_sp);
1076     }
1077   }
1078 }
1079 
GetUUID()1080 UUID ObjectFilePECOFF::GetUUID() {
1081   if (m_uuid.IsValid())
1082     return m_uuid;
1083 
1084   if (!CreateBinary())
1085     return UUID();
1086 
1087   m_uuid = GetCoffUUID(*m_binary);
1088   return m_uuid;
1089 }
1090 
GetDebugLink()1091 std::optional<FileSpec> ObjectFilePECOFF::GetDebugLink() {
1092   std::string gnu_debuglink_file;
1093   uint32_t gnu_debuglink_crc;
1094   if (GetDebugLinkContents(*m_binary, gnu_debuglink_file, gnu_debuglink_crc))
1095     return FileSpec(gnu_debuglink_file);
1096   return std::nullopt;
1097 }
1098 
ParseDependentModules()1099 uint32_t ObjectFilePECOFF::ParseDependentModules() {
1100   ModuleSP module_sp(GetModule());
1101   if (!module_sp)
1102     return 0;
1103 
1104   std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
1105   if (m_deps_filespec)
1106     return m_deps_filespec->GetSize();
1107 
1108   // Cache coff binary if it is not done yet.
1109   if (!CreateBinary())
1110     return 0;
1111 
1112   Log *log = GetLog(LLDBLog::Object);
1113   LLDB_LOG(log, "this = {0}, module = {1} ({2}), file = {3}, binary = {4}",
1114            this, GetModule().get(), GetModule()->GetSpecificationDescription(),
1115            m_file.GetPath(), m_binary.get());
1116 
1117   m_deps_filespec = FileSpecList();
1118 
1119   for (const auto &entry : m_binary->import_directories()) {
1120     llvm::StringRef dll_name;
1121     // Report a bogus entry.
1122     if (llvm::Error e = entry.getName(dll_name)) {
1123       LLDB_LOGF(log,
1124                 "ObjectFilePECOFF::ParseDependentModules() - failed to get "
1125                 "import directory entry name: %s",
1126                 llvm::toString(std::move(e)).c_str());
1127       continue;
1128     }
1129 
1130     // At this moment we only have the base name of the DLL. The full path can
1131     // only be seen after the dynamic loading.  Our best guess is Try to get it
1132     // with the help of the object file's directory.
1133     llvm::SmallString<128> dll_fullpath;
1134     FileSpec dll_specs(dll_name);
1135     dll_specs.SetDirectory(m_file.GetDirectory());
1136 
1137     if (!llvm::sys::fs::real_path(dll_specs.GetPath(), dll_fullpath))
1138       m_deps_filespec->EmplaceBack(dll_fullpath);
1139     else {
1140       // Known DLLs or DLL not found in the object file directory.
1141       m_deps_filespec->EmplaceBack(dll_name);
1142     }
1143   }
1144   return m_deps_filespec->GetSize();
1145 }
1146 
GetDependentModules(FileSpecList & files)1147 uint32_t ObjectFilePECOFF::GetDependentModules(FileSpecList &files) {
1148   auto num_modules = ParseDependentModules();
1149   auto original_size = files.GetSize();
1150 
1151   for (unsigned i = 0; i < num_modules; ++i)
1152     files.AppendIfUnique(m_deps_filespec->GetFileSpecAtIndex(i));
1153 
1154   return files.GetSize() - original_size;
1155 }
1156 
GetEntryPointAddress()1157 lldb_private::Address ObjectFilePECOFF::GetEntryPointAddress() {
1158   if (m_entry_point_address.IsValid())
1159     return m_entry_point_address;
1160 
1161   if (!ParseHeader() || !IsExecutable())
1162     return m_entry_point_address;
1163 
1164   SectionList *section_list = GetSectionList();
1165   addr_t file_addr = m_coff_header_opt.entry + m_coff_header_opt.image_base;
1166 
1167   if (!section_list)
1168     m_entry_point_address.SetOffset(file_addr);
1169   else
1170     m_entry_point_address.ResolveAddressUsingFileSections(file_addr,
1171                                                           section_list);
1172   return m_entry_point_address;
1173 }
1174 
GetBaseAddress()1175 Address ObjectFilePECOFF::GetBaseAddress() {
1176   return Address(GetSectionList()->GetSectionAtIndex(0), 0);
1177 }
1178 
1179 // Dump
1180 //
1181 // Dump the specifics of the runtime file container (such as any headers
1182 // segments, sections, etc).
Dump(Stream * s)1183 void ObjectFilePECOFF::Dump(Stream *s) {
1184   ModuleSP module_sp(GetModule());
1185   if (module_sp) {
1186     std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
1187     s->Printf("%p: ", static_cast<void *>(this));
1188     s->Indent();
1189     s->PutCString("ObjectFilePECOFF");
1190 
1191     ArchSpec header_arch = GetArchitecture();
1192 
1193     *s << ", file = '" << m_file
1194        << "', arch = " << header_arch.GetArchitectureName() << "\n";
1195 
1196     SectionList *sections = GetSectionList();
1197     if (sections)
1198       sections->Dump(s->AsRawOstream(), s->GetIndentLevel(), nullptr, true,
1199                      UINT32_MAX);
1200 
1201     if (m_symtab_up)
1202       m_symtab_up->Dump(s, nullptr, eSortOrderNone);
1203 
1204     if (m_dos_header.e_magic)
1205       DumpDOSHeader(s, m_dos_header);
1206     if (m_coff_header.machine) {
1207       DumpCOFFHeader(s, m_coff_header);
1208       if (m_coff_header.hdrsize)
1209         DumpOptCOFFHeader(s, m_coff_header_opt);
1210     }
1211     s->EOL();
1212     DumpSectionHeaders(s);
1213     s->EOL();
1214 
1215     DumpDependentModules(s);
1216     s->EOL();
1217   }
1218 }
1219 
1220 // DumpDOSHeader
1221 //
1222 // Dump the MS-DOS header to the specified output stream
DumpDOSHeader(Stream * s,const dos_header_t & header)1223 void ObjectFilePECOFF::DumpDOSHeader(Stream *s, const dos_header_t &header) {
1224   s->PutCString("MSDOS Header\n");
1225   s->Printf("  e_magic    = 0x%4.4x\n", header.e_magic);
1226   s->Printf("  e_cblp     = 0x%4.4x\n", header.e_cblp);
1227   s->Printf("  e_cp       = 0x%4.4x\n", header.e_cp);
1228   s->Printf("  e_crlc     = 0x%4.4x\n", header.e_crlc);
1229   s->Printf("  e_cparhdr  = 0x%4.4x\n", header.e_cparhdr);
1230   s->Printf("  e_minalloc = 0x%4.4x\n", header.e_minalloc);
1231   s->Printf("  e_maxalloc = 0x%4.4x\n", header.e_maxalloc);
1232   s->Printf("  e_ss       = 0x%4.4x\n", header.e_ss);
1233   s->Printf("  e_sp       = 0x%4.4x\n", header.e_sp);
1234   s->Printf("  e_csum     = 0x%4.4x\n", header.e_csum);
1235   s->Printf("  e_ip       = 0x%4.4x\n", header.e_ip);
1236   s->Printf("  e_cs       = 0x%4.4x\n", header.e_cs);
1237   s->Printf("  e_lfarlc   = 0x%4.4x\n", header.e_lfarlc);
1238   s->Printf("  e_ovno     = 0x%4.4x\n", header.e_ovno);
1239   s->Printf("  e_res[4]   = { 0x%4.4x, 0x%4.4x, 0x%4.4x, 0x%4.4x }\n",
1240             header.e_res[0], header.e_res[1], header.e_res[2], header.e_res[3]);
1241   s->Printf("  e_oemid    = 0x%4.4x\n", header.e_oemid);
1242   s->Printf("  e_oeminfo  = 0x%4.4x\n", header.e_oeminfo);
1243   s->Printf("  e_res2[10] = { 0x%4.4x, 0x%4.4x, 0x%4.4x, 0x%4.4x, 0x%4.4x, "
1244             "0x%4.4x, 0x%4.4x, 0x%4.4x, 0x%4.4x, 0x%4.4x }\n",
1245             header.e_res2[0], header.e_res2[1], header.e_res2[2],
1246             header.e_res2[3], header.e_res2[4], header.e_res2[5],
1247             header.e_res2[6], header.e_res2[7], header.e_res2[8],
1248             header.e_res2[9]);
1249   s->Printf("  e_lfanew   = 0x%8.8x\n", header.e_lfanew);
1250 }
1251 
1252 // DumpCOFFHeader
1253 //
1254 // Dump the COFF header to the specified output stream
DumpCOFFHeader(Stream * s,const coff_header_t & header)1255 void ObjectFilePECOFF::DumpCOFFHeader(Stream *s, const coff_header_t &header) {
1256   s->PutCString("COFF Header\n");
1257   s->Printf("  machine = 0x%4.4x\n", header.machine);
1258   s->Printf("  nsects  = 0x%4.4x\n", header.nsects);
1259   s->Printf("  modtime = 0x%8.8x\n", header.modtime);
1260   s->Printf("  symoff  = 0x%8.8x\n", header.symoff);
1261   s->Printf("  nsyms   = 0x%8.8x\n", header.nsyms);
1262   s->Printf("  hdrsize = 0x%4.4x\n", header.hdrsize);
1263 }
1264 
1265 // DumpOptCOFFHeader
1266 //
1267 // Dump the optional COFF header to the specified output stream
DumpOptCOFFHeader(Stream * s,const coff_opt_header_t & header)1268 void ObjectFilePECOFF::DumpOptCOFFHeader(Stream *s,
1269                                          const coff_opt_header_t &header) {
1270   s->PutCString("Optional COFF Header\n");
1271   s->Printf("  magic                   = 0x%4.4x\n", header.magic);
1272   s->Printf("  major_linker_version    = 0x%2.2x\n",
1273             header.major_linker_version);
1274   s->Printf("  minor_linker_version    = 0x%2.2x\n",
1275             header.minor_linker_version);
1276   s->Printf("  code_size               = 0x%8.8x\n", header.code_size);
1277   s->Printf("  data_size               = 0x%8.8x\n", header.data_size);
1278   s->Printf("  bss_size                = 0x%8.8x\n", header.bss_size);
1279   s->Printf("  entry                   = 0x%8.8x\n", header.entry);
1280   s->Printf("  code_offset             = 0x%8.8x\n", header.code_offset);
1281   s->Printf("  data_offset             = 0x%8.8x\n", header.data_offset);
1282   s->Printf("  image_base              = 0x%16.16" PRIx64 "\n",
1283             header.image_base);
1284   s->Printf("  sect_alignment          = 0x%8.8x\n", header.sect_alignment);
1285   s->Printf("  file_alignment          = 0x%8.8x\n", header.file_alignment);
1286   s->Printf("  major_os_system_version = 0x%4.4x\n",
1287             header.major_os_system_version);
1288   s->Printf("  minor_os_system_version = 0x%4.4x\n",
1289             header.minor_os_system_version);
1290   s->Printf("  major_image_version     = 0x%4.4x\n",
1291             header.major_image_version);
1292   s->Printf("  minor_image_version     = 0x%4.4x\n",
1293             header.minor_image_version);
1294   s->Printf("  major_subsystem_version = 0x%4.4x\n",
1295             header.major_subsystem_version);
1296   s->Printf("  minor_subsystem_version = 0x%4.4x\n",
1297             header.minor_subsystem_version);
1298   s->Printf("  reserved1               = 0x%8.8x\n", header.reserved1);
1299   s->Printf("  image_size              = 0x%8.8x\n", header.image_size);
1300   s->Printf("  header_size             = 0x%8.8x\n", header.header_size);
1301   s->Printf("  checksum                = 0x%8.8x\n", header.checksum);
1302   s->Printf("  subsystem               = 0x%4.4x\n", header.subsystem);
1303   s->Printf("  dll_flags               = 0x%4.4x\n", header.dll_flags);
1304   s->Printf("  stack_reserve_size      = 0x%16.16" PRIx64 "\n",
1305             header.stack_reserve_size);
1306   s->Printf("  stack_commit_size       = 0x%16.16" PRIx64 "\n",
1307             header.stack_commit_size);
1308   s->Printf("  heap_reserve_size       = 0x%16.16" PRIx64 "\n",
1309             header.heap_reserve_size);
1310   s->Printf("  heap_commit_size        = 0x%16.16" PRIx64 "\n",
1311             header.heap_commit_size);
1312   s->Printf("  loader_flags            = 0x%8.8x\n", header.loader_flags);
1313   s->Printf("  num_data_dir_entries    = 0x%8.8x\n",
1314             (uint32_t)header.data_dirs.size());
1315   uint32_t i;
1316   for (i = 0; i < header.data_dirs.size(); i++) {
1317     s->Printf("  data_dirs[%2u] vmaddr = 0x%8.8x, vmsize = 0x%8.8x\n", i,
1318               header.data_dirs[i].vmaddr, header.data_dirs[i].vmsize);
1319   }
1320 }
1321 // DumpSectionHeader
1322 //
1323 // Dump a single ELF section header to the specified output stream
DumpSectionHeader(Stream * s,const section_header_t & sh)1324 void ObjectFilePECOFF::DumpSectionHeader(Stream *s,
1325                                          const section_header_t &sh) {
1326   std::string name = std::string(GetSectionName(sh));
1327   s->Printf("%-16s 0x%8.8x 0x%8.8x 0x%8.8x 0x%8.8x 0x%8.8x 0x%8.8x 0x%4.4x "
1328             "0x%4.4x 0x%8.8x\n",
1329             name.c_str(), sh.vmaddr, sh.vmsize, sh.offset, sh.size, sh.reloff,
1330             sh.lineoff, sh.nreloc, sh.nline, sh.flags);
1331 }
1332 
1333 // DumpSectionHeaders
1334 //
1335 // Dump all of the ELF section header to the specified output stream
DumpSectionHeaders(Stream * s)1336 void ObjectFilePECOFF::DumpSectionHeaders(Stream *s) {
1337 
1338   s->PutCString("Section Headers\n");
1339   s->PutCString("IDX  name             vm addr    vm size    file off   file "
1340                 "size  reloc off  line off   nreloc nline  flags\n");
1341   s->PutCString("==== ---------------- ---------- ---------- ---------- "
1342                 "---------- ---------- ---------- ------ ------ ----------\n");
1343 
1344   uint32_t idx = 0;
1345   SectionHeaderCollIter pos, end = m_sect_headers.end();
1346 
1347   for (pos = m_sect_headers.begin(); pos != end; ++pos, ++idx) {
1348     s->Printf("[%2u] ", idx);
1349     ObjectFilePECOFF::DumpSectionHeader(s, *pos);
1350   }
1351 }
1352 
1353 // DumpDependentModules
1354 //
1355 // Dump all of the dependent modules to the specified output stream
DumpDependentModules(lldb_private::Stream * s)1356 void ObjectFilePECOFF::DumpDependentModules(lldb_private::Stream *s) {
1357   auto num_modules = ParseDependentModules();
1358   if (num_modules > 0) {
1359     s->PutCString("Dependent Modules\n");
1360     for (unsigned i = 0; i < num_modules; ++i) {
1361       auto spec = m_deps_filespec->GetFileSpecAtIndex(i);
1362       s->Printf("  %s\n", spec.GetFilename().GetCString());
1363     }
1364   }
1365 }
1366 
IsWindowsSubsystem()1367 bool ObjectFilePECOFF::IsWindowsSubsystem() {
1368   switch (m_coff_header_opt.subsystem) {
1369   case llvm::COFF::IMAGE_SUBSYSTEM_NATIVE:
1370   case llvm::COFF::IMAGE_SUBSYSTEM_WINDOWS_GUI:
1371   case llvm::COFF::IMAGE_SUBSYSTEM_WINDOWS_CUI:
1372   case llvm::COFF::IMAGE_SUBSYSTEM_NATIVE_WINDOWS:
1373   case llvm::COFF::IMAGE_SUBSYSTEM_WINDOWS_CE_GUI:
1374   case llvm::COFF::IMAGE_SUBSYSTEM_XBOX:
1375   case llvm::COFF::IMAGE_SUBSYSTEM_WINDOWS_BOOT_APPLICATION:
1376     return true;
1377   default:
1378     return false;
1379   }
1380 }
1381 
GetArchitecture()1382 ArchSpec ObjectFilePECOFF::GetArchitecture() {
1383   uint16_t machine = m_coff_header.machine;
1384   switch (machine) {
1385   default:
1386     break;
1387   case llvm::COFF::IMAGE_FILE_MACHINE_AMD64:
1388   case llvm::COFF::IMAGE_FILE_MACHINE_I386:
1389   case llvm::COFF::IMAGE_FILE_MACHINE_POWERPC:
1390   case llvm::COFF::IMAGE_FILE_MACHINE_POWERPCFP:
1391   case llvm::COFF::IMAGE_FILE_MACHINE_ARM:
1392   case llvm::COFF::IMAGE_FILE_MACHINE_ARMNT:
1393   case llvm::COFF::IMAGE_FILE_MACHINE_THUMB:
1394   case llvm::COFF::IMAGE_FILE_MACHINE_ARM64:
1395     ArchSpec arch;
1396     arch.SetArchitecture(eArchTypeCOFF, machine, LLDB_INVALID_CPUTYPE,
1397                          IsWindowsSubsystem() ? llvm::Triple::Win32
1398                                               : llvm::Triple::UnknownOS);
1399     return arch;
1400   }
1401   return ArchSpec();
1402 }
1403 
CalculateType()1404 ObjectFile::Type ObjectFilePECOFF::CalculateType() {
1405   if (m_coff_header.machine != 0) {
1406     if ((m_coff_header.flags & llvm::COFF::IMAGE_FILE_DLL) == 0)
1407       return eTypeExecutable;
1408     else
1409       return eTypeSharedLibrary;
1410   }
1411   return eTypeExecutable;
1412 }
1413 
CalculateStrata()1414 ObjectFile::Strata ObjectFilePECOFF::CalculateStrata() { return eStrataUser; }
1415