1 //===-- ObjectFileMachO.h ---------------------------------------*- C++ -*-===// 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 #ifndef liblldb_ObjectFileMachO_h_ 10 #define liblldb_ObjectFileMachO_h_ 11 12 #include "lldb/Core/Address.h" 13 #include "lldb/Core/FileSpecList.h" 14 #include "lldb/Host/SafeMachO.h" 15 #include "lldb/Symbol/ObjectFile.h" 16 #include "lldb/Utility/FileSpec.h" 17 #include "lldb/Utility/RangeMap.h" 18 #include "lldb/Utility/UUID.h" 19 20 // This class needs to be hidden as eventually belongs in a plugin that 21 // will export the ObjectFile protocol 22 class ObjectFileMachO : public lldb_private::ObjectFile { 23 public: 24 ObjectFileMachO(const lldb::ModuleSP &module_sp, lldb::DataBufferSP &data_sp, 25 lldb::offset_t data_offset, 26 const lldb_private::FileSpec *file, lldb::offset_t offset, 27 lldb::offset_t length); 28 29 ObjectFileMachO(const lldb::ModuleSP &module_sp, lldb::DataBufferSP &data_sp, 30 const lldb::ProcessSP &process_sp, lldb::addr_t header_addr); 31 32 ~ObjectFileMachO() override = default; 33 34 // Static Functions 35 static void Initialize(); 36 37 static void Terminate(); 38 39 static lldb_private::ConstString GetPluginNameStatic(); 40 41 static const char *GetPluginDescriptionStatic(); 42 43 static lldb_private::ObjectFile * 44 CreateInstance(const lldb::ModuleSP &module_sp, lldb::DataBufferSP &data_sp, 45 lldb::offset_t data_offset, const lldb_private::FileSpec *file, 46 lldb::offset_t file_offset, lldb::offset_t length); 47 48 static lldb_private::ObjectFile *CreateMemoryInstance( 49 const lldb::ModuleSP &module_sp, lldb::DataBufferSP &data_sp, 50 const lldb::ProcessSP &process_sp, lldb::addr_t header_addr); 51 52 static size_t GetModuleSpecifications(const lldb_private::FileSpec &file, 53 lldb::DataBufferSP &data_sp, 54 lldb::offset_t data_offset, 55 lldb::offset_t file_offset, 56 lldb::offset_t length, 57 lldb_private::ModuleSpecList &specs); 58 59 static bool SaveCore(const lldb::ProcessSP &process_sp, 60 const lldb_private::FileSpec &outfile, 61 lldb_private::Status &error); 62 63 static bool MagicBytesMatch(lldb::DataBufferSP &data_sp, lldb::addr_t offset, 64 lldb::addr_t length); 65 66 // LLVM RTTI support 67 static char ID; 68 bool isA(const void *ClassID) const override { 69 return ClassID == &ID || ObjectFile::isA(ClassID); 70 } 71 static bool classof(const ObjectFile *obj) { return obj->isA(&ID); } 72 73 // Member Functions 74 bool ParseHeader() override; 75 76 bool SetLoadAddress(lldb_private::Target &target, lldb::addr_t value, 77 bool value_is_offset) override; 78 79 lldb::ByteOrder GetByteOrder() const override; 80 81 bool IsExecutable() const override; 82 83 bool IsDynamicLoader() const; 84 85 uint32_t GetAddressByteSize() const override; 86 87 lldb_private::AddressClass GetAddressClass(lldb::addr_t file_addr) override; 88 89 lldb_private::Symtab *GetSymtab() override; 90 91 bool IsStripped() override; 92 93 void CreateSections(lldb_private::SectionList &unified_section_list) override; 94 95 void Dump(lldb_private::Stream *s) override; 96 97 lldb_private::ArchSpec GetArchitecture() override; 98 99 lldb_private::UUID GetUUID() override; 100 101 uint32_t GetDependentModules(lldb_private::FileSpecList &files) override; 102 103 lldb_private::FileSpecList GetReExportedLibraries() override { 104 return m_reexported_dylibs; 105 } 106 107 lldb_private::Address GetEntryPointAddress() override; 108 109 lldb_private::Address GetBaseAddress() override; 110 111 uint32_t GetNumThreadContexts() override; 112 113 std::string GetIdentifierString() override; 114 115 bool GetCorefileMainBinaryInfo (lldb::addr_t &address, lldb_private::UUID &uuid) override; 116 117 lldb::RegisterContextSP 118 GetThreadContextAtIndex(uint32_t idx, lldb_private::Thread &thread) override; 119 120 ObjectFile::Type CalculateType() override; 121 122 ObjectFile::Strata CalculateStrata() override; 123 124 llvm::VersionTuple GetVersion() override; 125 126 llvm::VersionTuple GetMinimumOSVersion() override; 127 128 llvm::VersionTuple GetSDKVersion() override; 129 130 bool GetIsDynamicLinkEditor() override; 131 132 static bool ParseHeader(lldb_private::DataExtractor &data, 133 lldb::offset_t *data_offset_ptr, 134 llvm::MachO::mach_header &header); 135 136 bool AllowAssemblyEmulationUnwindPlans() override; 137 138 // PluginInterface protocol 139 lldb_private::ConstString GetPluginName() override; 140 141 uint32_t GetPluginVersion() override; 142 143 protected: 144 static lldb_private::UUID 145 GetUUID(const llvm::MachO::mach_header &header, 146 const lldb_private::DataExtractor &data, 147 lldb::offset_t lc_offset); // Offset to the first load command 148 149 static lldb_private::ArchSpec 150 GetArchitecture(const llvm::MachO::mach_header &header, 151 const lldb_private::DataExtractor &data, 152 lldb::offset_t lc_offset); 153 154 // Intended for same-host arm device debugging where lldb needs to 155 // detect libraries in the shared cache and augment the nlist entries 156 // with an on-disk dyld_shared_cache file. The process will record 157 // the shared cache UUID so the on-disk cache can be matched or rejected 158 // correctly. 159 void GetProcessSharedCacheUUID(lldb_private::Process *, lldb::addr_t &base_addr, lldb_private::UUID &uuid); 160 161 // Intended for same-host arm device debugging where lldb will read 162 // shared cache libraries out of its own memory instead of the remote 163 // process' memory as an optimization. If lldb's shared cache UUID 164 // does not match the process' shared cache UUID, this optimization 165 // should not be used. 166 void GetLLDBSharedCacheUUID(lldb::addr_t &base_addir, lldb_private::UUID &uuid); 167 168 lldb_private::Section *GetMachHeaderSection(); 169 170 lldb::addr_t CalculateSectionLoadAddressForMemoryImage( 171 lldb::addr_t mach_header_load_address, 172 const lldb_private::Section *mach_header_section, 173 const lldb_private::Section *section); 174 175 lldb_private::UUID 176 GetSharedCacheUUID(lldb_private::FileSpec dyld_shared_cache, 177 const lldb::ByteOrder byte_order, 178 const uint32_t addr_byte_size); 179 180 size_t ParseSymtab(); 181 182 typedef lldb_private::RangeArray<uint32_t, uint32_t, 8> EncryptedFileRanges; 183 EncryptedFileRanges GetEncryptedFileRanges(); 184 185 struct SegmentParsingContext; 186 void ProcessDysymtabCommand(const llvm::MachO::load_command &load_cmd, 187 lldb::offset_t offset); 188 void ProcessSegmentCommand(const llvm::MachO::load_command &load_cmd, 189 lldb::offset_t offset, uint32_t cmd_idx, 190 SegmentParsingContext &context); 191 void SanitizeSegmentCommand(llvm::MachO::segment_command_64 &seg_cmd, 192 uint32_t cmd_idx); 193 194 bool SectionIsLoadable(const lldb_private::Section *section); 195 196 llvm::MachO::mach_header m_header; 197 static lldb_private::ConstString GetSegmentNameTEXT(); 198 static lldb_private::ConstString GetSegmentNameDATA(); 199 static lldb_private::ConstString GetSegmentNameDATA_DIRTY(); 200 static lldb_private::ConstString GetSegmentNameDATA_CONST(); 201 static lldb_private::ConstString GetSegmentNameOBJC(); 202 static lldb_private::ConstString GetSegmentNameLINKEDIT(); 203 static lldb_private::ConstString GetSegmentNameDWARF(); 204 static lldb_private::ConstString GetSectionNameEHFrame(); 205 206 llvm::MachO::dysymtab_command m_dysymtab; 207 std::vector<llvm::MachO::segment_command_64> m_mach_segments; 208 std::vector<llvm::MachO::section_64> m_mach_sections; 209 llvm::Optional<llvm::VersionTuple> m_min_os_version; 210 llvm::Optional<llvm::VersionTuple> m_sdk_versions; 211 typedef lldb_private::RangeVector<uint32_t, uint32_t> FileRangeArray; 212 lldb_private::Address m_entry_point_address; 213 FileRangeArray m_thread_context_offsets; 214 bool m_thread_context_offsets_valid; 215 lldb_private::FileSpecList m_reexported_dylibs; 216 bool m_allow_assembly_emulation_unwind_plans; 217 }; 218 219 #endif // liblldb_ObjectFileMachO_h_ 220