1 //===-- ObjectFileJIT.cpp ---------------------------------------*- C++ -*-===//
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
7 //===----------------------------------------------------------------------===//
9 #include "llvm/ADT/StringRef.h"
11 #include "ObjectFileJIT.h"
12 #include "lldb/Core/Debugger.h"
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/Host/Host.h"
20 #include "lldb/Symbol/ObjectFile.h"
21 #include "lldb/Target/Platform.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/DataBuffer.h"
27 #include "lldb/Utility/DataBufferHeap.h"
28 #include "lldb/Utility/FileSpec.h"
29 #include "lldb/Utility/Log.h"
30 #include "lldb/Utility/RangeMap.h"
31 #include "lldb/Utility/StreamString.h"
32 #include "lldb/Utility/Timer.h"
33 #include "lldb/Utility/UUID.h"
36 #include "Utility/UuidCompatibility.h"
40 using namespace lldb_private;
42 void ObjectFileJIT::Initialize() {
43 PluginManager::RegisterPlugin(GetPluginNameStatic(),
44 GetPluginDescriptionStatic(), CreateInstance,
45 CreateMemoryInstance, GetModuleSpecifications);
48 void ObjectFileJIT::Terminate() {
49 PluginManager::UnregisterPlugin(CreateInstance);
52 lldb_private::ConstString ObjectFileJIT::GetPluginNameStatic() {
53 static ConstString g_name("jit");
57 const char *ObjectFileJIT::GetPluginDescriptionStatic() {
58 return "JIT code object file";
61 ObjectFile *ObjectFileJIT::CreateInstance(const lldb::ModuleSP &module_sp,
62 DataBufferSP &data_sp,
63 lldb::offset_t data_offset,
65 lldb::offset_t file_offset,
66 lldb::offset_t length) {
67 // JIT'ed object file is backed by the ObjectFileJITDelegate, never read from
72 ObjectFile *ObjectFileJIT::CreateMemoryInstance(const lldb::ModuleSP &module_sp,
73 DataBufferSP &data_sp,
74 const ProcessSP &process_sp,
75 lldb::addr_t header_addr) {
76 // JIT'ed object file is backed by the ObjectFileJITDelegate, never read from
81 size_t ObjectFileJIT::GetModuleSpecifications(
82 const lldb_private::FileSpec &file, lldb::DataBufferSP &data_sp,
83 lldb::offset_t data_offset, lldb::offset_t file_offset,
84 lldb::offset_t length, lldb_private::ModuleSpecList &specs) {
85 // JIT'ed object file can't be read from a file on disk
89 ObjectFileJIT::ObjectFileJIT(const lldb::ModuleSP &module_sp,
90 const ObjectFileJITDelegateSP &delegate_sp)
91 : ObjectFile(module_sp, nullptr, 0, 0, DataBufferSP(), 0), m_delegate_wp() {
93 m_delegate_wp = delegate_sp;
94 m_data.SetByteOrder(delegate_sp->GetByteOrder());
95 m_data.SetAddressByteSize(delegate_sp->GetAddressByteSize());
99 ObjectFileJIT::~ObjectFileJIT() {}
101 bool ObjectFileJIT::ParseHeader() {
102 // JIT code is never in a file, nor is it required to have any header
106 ByteOrder ObjectFileJIT::GetByteOrder() const { return m_data.GetByteOrder(); }
108 bool ObjectFileJIT::IsExecutable() const { return false; }
110 uint32_t ObjectFileJIT::GetAddressByteSize() const {
111 return m_data.GetAddressByteSize();
114 Symtab *ObjectFileJIT::GetSymtab() {
115 ModuleSP module_sp(GetModule());
117 std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
118 if (m_symtab_up == nullptr) {
119 m_symtab_up.reset(new Symtab(this));
120 std::lock_guard<std::recursive_mutex> symtab_guard(
121 m_symtab_up->GetMutex());
122 ObjectFileJITDelegateSP delegate_sp(m_delegate_wp.lock());
124 delegate_sp->PopulateSymtab(this, *m_symtab_up);
125 // TODO: get symbols from delegate
126 m_symtab_up->Finalize();
129 return m_symtab_up.get();
132 bool ObjectFileJIT::IsStripped() {
133 return false; // JIT code that is in a module is never stripped
136 void ObjectFileJIT::CreateSections(SectionList &unified_section_list) {
137 if (!m_sections_up) {
138 m_sections_up.reset(new SectionList());
139 ObjectFileJITDelegateSP delegate_sp(m_delegate_wp.lock());
141 delegate_sp->PopulateSectionList(this, *m_sections_up);
142 unified_section_list = *m_sections_up;
147 void ObjectFileJIT::Dump(Stream *s) {
148 ModuleSP module_sp(GetModule());
150 std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
151 s->Printf("%p: ", static_cast<void *>(this));
153 s->PutCString("ObjectFileJIT");
155 if (ArchSpec arch = GetArchitecture())
156 *s << ", arch = " << arch.GetArchitectureName();
160 SectionList *sections = GetSectionList();
162 sections->Dump(s, nullptr, true, UINT32_MAX);
165 m_symtab_up->Dump(s, nullptr, eSortOrderNone);
169 UUID ObjectFileJIT::GetUUID() {
170 // TODO: maybe get from delegate, not needed for first pass
174 uint32_t ObjectFileJIT::GetDependentModules(FileSpecList &files) {
175 // JIT modules don't have dependencies, but they could
176 // if external functions are called and we know where they are
181 lldb_private::Address ObjectFileJIT::GetEntryPointAddress() {
185 lldb_private::Address ObjectFileJIT::GetBaseAddress() { return Address(); }
187 ObjectFile::Type ObjectFileJIT::CalculateType() { return eTypeJIT; }
189 ObjectFile::Strata ObjectFileJIT::CalculateStrata() { return eStrataJIT; }
191 ArchSpec ObjectFileJIT::GetArchitecture() {
192 if (ObjectFileJITDelegateSP delegate_sp = m_delegate_wp.lock())
193 return delegate_sp->GetArchitecture();
197 // PluginInterface protocol
198 lldb_private::ConstString ObjectFileJIT::GetPluginName() {
199 return GetPluginNameStatic();
202 uint32_t ObjectFileJIT::GetPluginVersion() { return 1; }
204 bool ObjectFileJIT::SetLoadAddress(Target &target, lldb::addr_t value,
205 bool value_is_offset) {
206 size_t num_loaded_sections = 0;
207 SectionList *section_list = GetSectionList();
209 const size_t num_sections = section_list->GetSize();
210 // "value" is an offset to apply to each top level segment
211 for (size_t sect_idx = 0; sect_idx < num_sections; ++sect_idx) {
212 // Iterate through the object file sections to find all of the sections
213 // that size on disk (to avoid __PAGEZERO) and load them
214 SectionSP section_sp(section_list->GetSectionAtIndex(sect_idx));
215 if (section_sp && section_sp->GetFileSize() > 0 &&
216 !section_sp->IsThreadSpecific()) {
217 if (target.GetSectionLoadList().SetSectionLoadAddress(
218 section_sp, section_sp->GetFileAddress() + value))
219 ++num_loaded_sections;
223 return num_loaded_sections > 0;
226 size_t ObjectFileJIT::ReadSectionData(lldb_private::Section *section,
227 lldb::offset_t section_offset, void *dst,
229 lldb::offset_t file_size = section->GetFileSize();
230 if (section_offset < file_size) {
231 size_t src_len = file_size - section_offset;
232 if (src_len > dst_len)
235 ((uint8_t *)(uintptr_t)section->GetFileOffset()) + section_offset;
237 memcpy(dst, src, src_len);
243 size_t ObjectFileJIT::ReadSectionData(
244 lldb_private::Section *section,
245 lldb_private::DataExtractor §ion_data) {
246 if (section->GetFileSize()) {
247 const void *src = (void *)(uintptr_t)section->GetFileOffset();
249 DataBufferSP data_sp =
250 std::make_shared<DataBufferHeap>(src, section->GetFileSize());
251 section_data.SetData(data_sp, 0, data_sp->GetByteSize());
252 section_data.SetByteOrder(GetByteOrder());
253 section_data.SetAddressByteSize(GetAddressByteSize());
254 return section_data.GetByteSize();
256 section_data.Clear();