1 //===-- ObjectFile.cpp ------------------------------------------*- 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 #include "lldb/Symbol/ObjectFile.h"
10 #include "lldb/Core/Module.h"
11 #include "lldb/Core/ModuleSpec.h"
12 #include "lldb/Core/PluginManager.h"
13 #include "lldb/Core/Section.h"
14 #include "lldb/Symbol/ObjectContainer.h"
15 #include "lldb/Symbol/SymbolFile.h"
16 #include "lldb/Target/Process.h"
17 #include "lldb/Target/SectionLoadList.h"
18 #include "lldb/Target/Target.h"
19 #include "lldb/Utility/DataBuffer.h"
20 #include "lldb/Utility/DataBufferHeap.h"
21 #include "lldb/Utility/Log.h"
22 #include "lldb/Utility/RegularExpression.h"
23 #include "lldb/Utility/Timer.h"
24 #include "lldb/lldb-private.h"
25 
26 using namespace lldb;
27 using namespace lldb_private;
28 
29 char ObjectFile::ID;
30 
31 ObjectFileSP
32 ObjectFile::FindPlugin(const lldb::ModuleSP &module_sp, const FileSpec *file,
33                        lldb::offset_t file_offset, lldb::offset_t file_size,
34                        DataBufferSP &data_sp, lldb::offset_t &data_offset) {
35   ObjectFileSP object_file_sp;
36 
37   if (module_sp) {
38     static Timer::Category func_cat(LLVM_PRETTY_FUNCTION);
39     Timer scoped_timer(
40         func_cat,
41         "ObjectFile::FindPlugin (module = %s, file = %p, file_offset = "
42         "0x%8.8" PRIx64 ", file_size = 0x%8.8" PRIx64 ")",
43         module_sp->GetFileSpec().GetPath().c_str(),
44         static_cast<const void *>(file), static_cast<uint64_t>(file_offset),
45         static_cast<uint64_t>(file_size));
46     if (file) {
47       FileSpec archive_file;
48       ObjectContainerCreateInstance create_object_container_callback;
49 
50       const bool file_exists = FileSystem::Instance().Exists(*file);
51       if (!data_sp) {
52         // We have an object name which most likely means we have a .o file in
53         // a static archive (.a file). Try and see if we have a cached archive
54         // first without reading any data first
55         if (file_exists && module_sp->GetObjectName()) {
56           for (uint32_t idx = 0;
57                (create_object_container_callback =
58                     PluginManager::GetObjectContainerCreateCallbackAtIndex(
59                         idx)) != nullptr;
60                ++idx) {
61             std::unique_ptr<ObjectContainer> object_container_up(
62                 create_object_container_callback(module_sp, data_sp,
63                                                  data_offset, file, file_offset,
64                                                  file_size));
65 
66             if (object_container_up)
67               object_file_sp = object_container_up->GetObjectFile(file);
68 
69             if (object_file_sp.get())
70               return object_file_sp;
71           }
72         }
73         // Ok, we didn't find any containers that have a named object, now lets
74         // read the first 512 bytes from the file so the object file and object
75         // container plug-ins can use these bytes to see if they can parse this
76         // file.
77         if (file_size > 0) {
78           data_sp = FileSystem::Instance().CreateDataBuffer(file->GetPath(),
79                                                             512, file_offset);
80           data_offset = 0;
81         }
82       }
83 
84       if (!data_sp || data_sp->GetByteSize() == 0) {
85         // Check for archive file with format "/path/to/archive.a(object.o)"
86         char path_with_object[PATH_MAX * 2];
87         module_sp->GetFileSpec().GetPath(path_with_object,
88                                          sizeof(path_with_object));
89 
90         ConstString archive_object;
91         const bool must_exist = true;
92         if (ObjectFile::SplitArchivePathWithObject(
93                 path_with_object, archive_file, archive_object, must_exist)) {
94           file_size = FileSystem::Instance().GetByteSize(archive_file);
95           if (file_size > 0) {
96             file = &archive_file;
97             module_sp->SetFileSpecAndObjectName(archive_file, archive_object);
98             // Check if this is a object container by iterating through all
99             // object container plugin instances and then trying to get an
100             // object file from the container plugins since we had a name.
101             // Also, don't read
102             // ANY data in case there is data cached in the container plug-ins
103             // (like BSD archives caching the contained objects within an
104             // file).
105             for (uint32_t idx = 0;
106                  (create_object_container_callback =
107                       PluginManager::GetObjectContainerCreateCallbackAtIndex(
108                           idx)) != nullptr;
109                  ++idx) {
110               std::unique_ptr<ObjectContainer> object_container_up(
111                   create_object_container_callback(module_sp, data_sp,
112                                                    data_offset, file,
113                                                    file_offset, file_size));
114 
115               if (object_container_up)
116                 object_file_sp = object_container_up->GetObjectFile(file);
117 
118               if (object_file_sp.get())
119                 return object_file_sp;
120             }
121             // We failed to find any cached object files in the container plug-
122             // ins, so lets read the first 512 bytes and try again below...
123             data_sp = FileSystem::Instance().CreateDataBuffer(
124                 archive_file.GetPath(), 512, file_offset);
125           }
126         }
127       }
128 
129       if (data_sp && data_sp->GetByteSize() > 0) {
130         // Check if this is a normal object file by iterating through all
131         // object file plugin instances.
132         ObjectFileCreateInstance create_object_file_callback;
133         for (uint32_t idx = 0;
134              (create_object_file_callback =
135                   PluginManager::GetObjectFileCreateCallbackAtIndex(idx)) !=
136              nullptr;
137              ++idx) {
138           object_file_sp.reset(create_object_file_callback(
139               module_sp, data_sp, data_offset, file, file_offset, file_size));
140           if (object_file_sp.get())
141             return object_file_sp;
142         }
143 
144         // Check if this is a object container by iterating through all object
145         // container plugin instances and then trying to get an object file
146         // from the container.
147         for (uint32_t idx = 0;
148              (create_object_container_callback =
149                   PluginManager::GetObjectContainerCreateCallbackAtIndex(
150                       idx)) != nullptr;
151              ++idx) {
152           std::unique_ptr<ObjectContainer> object_container_up(
153               create_object_container_callback(module_sp, data_sp, data_offset,
154                                                file, file_offset, file_size));
155 
156           if (object_container_up)
157             object_file_sp = object_container_up->GetObjectFile(file);
158 
159           if (object_file_sp.get())
160             return object_file_sp;
161         }
162       }
163     }
164   }
165   // We didn't find it, so clear our shared pointer in case it contains
166   // anything and return an empty shared pointer
167   object_file_sp.reset();
168   return object_file_sp;
169 }
170 
171 ObjectFileSP ObjectFile::FindPlugin(const lldb::ModuleSP &module_sp,
172                                     const ProcessSP &process_sp,
173                                     lldb::addr_t header_addr,
174                                     DataBufferSP &data_sp) {
175   ObjectFileSP object_file_sp;
176 
177   if (module_sp) {
178     static Timer::Category func_cat(LLVM_PRETTY_FUNCTION);
179     Timer scoped_timer(func_cat,
180                        "ObjectFile::FindPlugin (module = "
181                        "%s, process = %p, header_addr = "
182                        "0x%" PRIx64 ")",
183                        module_sp->GetFileSpec().GetPath().c_str(),
184                        static_cast<void *>(process_sp.get()), header_addr);
185     uint32_t idx;
186 
187     // Check if this is a normal object file by iterating through all object
188     // file plugin instances.
189     ObjectFileCreateMemoryInstance create_callback;
190     for (idx = 0;
191          (create_callback =
192               PluginManager::GetObjectFileCreateMemoryCallbackAtIndex(idx)) !=
193          nullptr;
194          ++idx) {
195       object_file_sp.reset(
196           create_callback(module_sp, data_sp, process_sp, header_addr));
197       if (object_file_sp.get())
198         return object_file_sp;
199     }
200   }
201 
202   // We didn't find it, so clear our shared pointer in case it contains
203   // anything and return an empty shared pointer
204   object_file_sp.reset();
205   return object_file_sp;
206 }
207 
208 size_t ObjectFile::GetModuleSpecifications(const FileSpec &file,
209                                            lldb::offset_t file_offset,
210                                            lldb::offset_t file_size,
211                                            ModuleSpecList &specs) {
212   DataBufferSP data_sp =
213       FileSystem::Instance().CreateDataBuffer(file.GetPath(), 512, file_offset);
214   if (data_sp) {
215     if (file_size == 0) {
216       const lldb::offset_t actual_file_size =
217           FileSystem::Instance().GetByteSize(file);
218       if (actual_file_size > file_offset)
219         file_size = actual_file_size - file_offset;
220     }
221     return ObjectFile::GetModuleSpecifications(file,        // file spec
222                                                data_sp,     // data bytes
223                                                0,           // data offset
224                                                file_offset, // file offset
225                                                file_size,   // file length
226                                                specs);
227   }
228   return 0;
229 }
230 
231 size_t ObjectFile::GetModuleSpecifications(
232     const lldb_private::FileSpec &file, lldb::DataBufferSP &data_sp,
233     lldb::offset_t data_offset, lldb::offset_t file_offset,
234     lldb::offset_t file_size, lldb_private::ModuleSpecList &specs) {
235   const size_t initial_count = specs.GetSize();
236   ObjectFileGetModuleSpecifications callback;
237   uint32_t i;
238   // Try the ObjectFile plug-ins
239   for (i = 0;
240        (callback =
241             PluginManager::GetObjectFileGetModuleSpecificationsCallbackAtIndex(
242                 i)) != nullptr;
243        ++i) {
244     if (callback(file, data_sp, data_offset, file_offset, file_size, specs) > 0)
245       return specs.GetSize() - initial_count;
246   }
247 
248   // Try the ObjectContainer plug-ins
249   for (i = 0;
250        (callback = PluginManager::
251             GetObjectContainerGetModuleSpecificationsCallbackAtIndex(i)) !=
252        nullptr;
253        ++i) {
254     if (callback(file, data_sp, data_offset, file_offset, file_size, specs) > 0)
255       return specs.GetSize() - initial_count;
256   }
257   return 0;
258 }
259 
260 ObjectFile::ObjectFile(const lldb::ModuleSP &module_sp,
261                        const FileSpec *file_spec_ptr,
262                        lldb::offset_t file_offset, lldb::offset_t length,
263                        const lldb::DataBufferSP &data_sp,
264                        lldb::offset_t data_offset)
265     : ModuleChild(module_sp),
266       m_file(), // This file could be different from the original module's file
267       m_type(eTypeInvalid), m_strata(eStrataInvalid),
268       m_file_offset(file_offset), m_length(length), m_data(), m_process_wp(),
269       m_memory_addr(LLDB_INVALID_ADDRESS), m_sections_up(), m_symtab_up(),
270       m_synthetic_symbol_idx(0) {
271   if (file_spec_ptr)
272     m_file = *file_spec_ptr;
273   if (data_sp)
274     m_data.SetData(data_sp, data_offset, length);
275   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
276   LLDB_LOGF(log,
277             "%p ObjectFile::ObjectFile() module = %p (%s), file = %s, "
278             "file_offset = 0x%8.8" PRIx64 ", size = %" PRIu64,
279             static_cast<void *>(this), static_cast<void *>(module_sp.get()),
280             module_sp->GetSpecificationDescription().c_str(),
281             m_file ? m_file.GetPath().c_str() : "<NULL>", m_file_offset,
282             m_length);
283 }
284 
285 ObjectFile::ObjectFile(const lldb::ModuleSP &module_sp,
286                        const ProcessSP &process_sp, lldb::addr_t header_addr,
287                        DataBufferSP &header_data_sp)
288     : ModuleChild(module_sp), m_file(), m_type(eTypeInvalid),
289       m_strata(eStrataInvalid), m_file_offset(0), m_length(0), m_data(),
290       m_process_wp(process_sp), m_memory_addr(header_addr), m_sections_up(),
291       m_symtab_up(), m_synthetic_symbol_idx(0) {
292   if (header_data_sp)
293     m_data.SetData(header_data_sp, 0, header_data_sp->GetByteSize());
294   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
295   LLDB_LOGF(log,
296             "%p ObjectFile::ObjectFile() module = %p (%s), process = %p, "
297             "header_addr = 0x%" PRIx64,
298             static_cast<void *>(this), static_cast<void *>(module_sp.get()),
299             module_sp->GetSpecificationDescription().c_str(),
300             static_cast<void *>(process_sp.get()), m_memory_addr);
301 }
302 
303 ObjectFile::~ObjectFile() {
304   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
305   LLDB_LOGF(log, "%p ObjectFile::~ObjectFile ()\n", static_cast<void *>(this));
306 }
307 
308 bool ObjectFile::SetModulesArchitecture(const ArchSpec &new_arch) {
309   ModuleSP module_sp(GetModule());
310   if (module_sp)
311     return module_sp->SetArchitecture(new_arch);
312   return false;
313 }
314 
315 AddressClass ObjectFile::GetAddressClass(addr_t file_addr) {
316   Symtab *symtab = GetSymtab();
317   if (symtab) {
318     Symbol *symbol = symtab->FindSymbolContainingFileAddress(file_addr);
319     if (symbol) {
320       if (symbol->ValueIsAddress()) {
321         const SectionSP section_sp(symbol->GetAddressRef().GetSection());
322         if (section_sp) {
323           const SectionType section_type = section_sp->GetType();
324           switch (section_type) {
325           case eSectionTypeInvalid:
326             return AddressClass::eUnknown;
327           case eSectionTypeCode:
328             return AddressClass::eCode;
329           case eSectionTypeContainer:
330             return AddressClass::eUnknown;
331           case eSectionTypeData:
332           case eSectionTypeDataCString:
333           case eSectionTypeDataCStringPointers:
334           case eSectionTypeDataSymbolAddress:
335           case eSectionTypeData4:
336           case eSectionTypeData8:
337           case eSectionTypeData16:
338           case eSectionTypeDataPointers:
339           case eSectionTypeZeroFill:
340           case eSectionTypeDataObjCMessageRefs:
341           case eSectionTypeDataObjCCFStrings:
342           case eSectionTypeGoSymtab:
343             return AddressClass::eData;
344           case eSectionTypeDebug:
345           case eSectionTypeDWARFDebugAbbrev:
346           case eSectionTypeDWARFDebugAbbrevDwo:
347           case eSectionTypeDWARFDebugAddr:
348           case eSectionTypeDWARFDebugAranges:
349           case eSectionTypeDWARFDebugCuIndex:
350           case eSectionTypeDWARFDebugFrame:
351           case eSectionTypeDWARFDebugInfo:
352           case eSectionTypeDWARFDebugInfoDwo:
353           case eSectionTypeDWARFDebugLine:
354           case eSectionTypeDWARFDebugLineStr:
355           case eSectionTypeDWARFDebugLoc:
356           case eSectionTypeDWARFDebugLocLists:
357           case eSectionTypeDWARFDebugMacInfo:
358           case eSectionTypeDWARFDebugMacro:
359           case eSectionTypeDWARFDebugNames:
360           case eSectionTypeDWARFDebugPubNames:
361           case eSectionTypeDWARFDebugPubTypes:
362           case eSectionTypeDWARFDebugRanges:
363           case eSectionTypeDWARFDebugRngLists:
364           case eSectionTypeDWARFDebugStr:
365           case eSectionTypeDWARFDebugStrDwo:
366           case eSectionTypeDWARFDebugStrOffsets:
367           case eSectionTypeDWARFDebugStrOffsetsDwo:
368           case eSectionTypeDWARFDebugTypes:
369           case eSectionTypeDWARFDebugTypesDwo:
370           case eSectionTypeDWARFAppleNames:
371           case eSectionTypeDWARFAppleTypes:
372           case eSectionTypeDWARFAppleNamespaces:
373           case eSectionTypeDWARFAppleObjC:
374           case eSectionTypeDWARFGNUDebugAltLink:
375             return AddressClass::eDebug;
376           case eSectionTypeEHFrame:
377           case eSectionTypeARMexidx:
378           case eSectionTypeARMextab:
379           case eSectionTypeCompactUnwind:
380             return AddressClass::eRuntime;
381           case eSectionTypeELFSymbolTable:
382           case eSectionTypeELFDynamicSymbols:
383           case eSectionTypeELFRelocationEntries:
384           case eSectionTypeELFDynamicLinkInfo:
385           case eSectionTypeOther:
386             return AddressClass::eUnknown;
387           case eSectionTypeAbsoluteAddress:
388             // In case of absolute sections decide the address class based on
389             // the symbol type because the section type isn't specify if it is
390             // a code or a data section.
391             break;
392           }
393         }
394       }
395 
396       const SymbolType symbol_type = symbol->GetType();
397       switch (symbol_type) {
398       case eSymbolTypeAny:
399         return AddressClass::eUnknown;
400       case eSymbolTypeAbsolute:
401         return AddressClass::eUnknown;
402       case eSymbolTypeCode:
403         return AddressClass::eCode;
404       case eSymbolTypeTrampoline:
405         return AddressClass::eCode;
406       case eSymbolTypeResolver:
407         return AddressClass::eCode;
408       case eSymbolTypeData:
409         return AddressClass::eData;
410       case eSymbolTypeRuntime:
411         return AddressClass::eRuntime;
412       case eSymbolTypeException:
413         return AddressClass::eRuntime;
414       case eSymbolTypeSourceFile:
415         return AddressClass::eDebug;
416       case eSymbolTypeHeaderFile:
417         return AddressClass::eDebug;
418       case eSymbolTypeObjectFile:
419         return AddressClass::eDebug;
420       case eSymbolTypeCommonBlock:
421         return AddressClass::eDebug;
422       case eSymbolTypeBlock:
423         return AddressClass::eDebug;
424       case eSymbolTypeLocal:
425         return AddressClass::eData;
426       case eSymbolTypeParam:
427         return AddressClass::eData;
428       case eSymbolTypeVariable:
429         return AddressClass::eData;
430       case eSymbolTypeVariableType:
431         return AddressClass::eDebug;
432       case eSymbolTypeLineEntry:
433         return AddressClass::eDebug;
434       case eSymbolTypeLineHeader:
435         return AddressClass::eDebug;
436       case eSymbolTypeScopeBegin:
437         return AddressClass::eDebug;
438       case eSymbolTypeScopeEnd:
439         return AddressClass::eDebug;
440       case eSymbolTypeAdditional:
441         return AddressClass::eUnknown;
442       case eSymbolTypeCompiler:
443         return AddressClass::eDebug;
444       case eSymbolTypeInstrumentation:
445         return AddressClass::eDebug;
446       case eSymbolTypeUndefined:
447         return AddressClass::eUnknown;
448       case eSymbolTypeObjCClass:
449         return AddressClass::eRuntime;
450       case eSymbolTypeObjCMetaClass:
451         return AddressClass::eRuntime;
452       case eSymbolTypeObjCIVar:
453         return AddressClass::eRuntime;
454       case eSymbolTypeReExported:
455         return AddressClass::eRuntime;
456       }
457     }
458   }
459   return AddressClass::eUnknown;
460 }
461 
462 DataBufferSP ObjectFile::ReadMemory(const ProcessSP &process_sp,
463                                     lldb::addr_t addr, size_t byte_size) {
464   DataBufferSP data_sp;
465   if (process_sp) {
466     std::unique_ptr<DataBufferHeap> data_up(new DataBufferHeap(byte_size, 0));
467     Status error;
468     const size_t bytes_read = process_sp->ReadMemory(
469         addr, data_up->GetBytes(), data_up->GetByteSize(), error);
470     if (bytes_read == byte_size)
471       data_sp.reset(data_up.release());
472   }
473   return data_sp;
474 }
475 
476 size_t ObjectFile::GetData(lldb::offset_t offset, size_t length,
477                            DataExtractor &data) const {
478   // The entire file has already been mmap'ed into m_data, so just copy from
479   // there as the back mmap buffer will be shared with shared pointers.
480   return data.SetData(m_data, offset, length);
481 }
482 
483 size_t ObjectFile::CopyData(lldb::offset_t offset, size_t length,
484                             void *dst) const {
485   // The entire file has already been mmap'ed into m_data, so just copy from
486   // there Note that the data remains in target byte order.
487   return m_data.CopyData(offset, length, dst);
488 }
489 
490 size_t ObjectFile::ReadSectionData(Section *section,
491                                    lldb::offset_t section_offset, void *dst,
492                                    size_t dst_len) {
493   assert(section);
494   section_offset *= section->GetTargetByteSize();
495 
496   // If some other objectfile owns this data, pass this to them.
497   if (section->GetObjectFile() != this)
498     return section->GetObjectFile()->ReadSectionData(section, section_offset,
499                                                      dst, dst_len);
500 
501   if (IsInMemory()) {
502     ProcessSP process_sp(m_process_wp.lock());
503     if (process_sp) {
504       Status error;
505       const addr_t base_load_addr =
506           section->GetLoadBaseAddress(&process_sp->GetTarget());
507       if (base_load_addr != LLDB_INVALID_ADDRESS)
508         return process_sp->ReadMemory(base_load_addr + section_offset, dst,
509                                       dst_len, error);
510     }
511   } else {
512     if (!section->IsRelocated())
513       RelocateSection(section);
514 
515     const lldb::offset_t section_file_size = section->GetFileSize();
516     if (section_offset < section_file_size) {
517       const size_t section_bytes_left = section_file_size - section_offset;
518       size_t section_dst_len = dst_len;
519       if (section_dst_len > section_bytes_left)
520         section_dst_len = section_bytes_left;
521       return CopyData(section->GetFileOffset() + section_offset,
522                       section_dst_len, dst);
523     } else {
524       if (section->GetType() == eSectionTypeZeroFill) {
525         const uint64_t section_size = section->GetByteSize();
526         const uint64_t section_bytes_left = section_size - section_offset;
527         uint64_t section_dst_len = dst_len;
528         if (section_dst_len > section_bytes_left)
529           section_dst_len = section_bytes_left;
530         memset(dst, 0, section_dst_len);
531         return section_dst_len;
532       }
533     }
534   }
535   return 0;
536 }
537 
538 // Get the section data the file on disk
539 size_t ObjectFile::ReadSectionData(Section *section,
540                                    DataExtractor &section_data) {
541   // If some other objectfile owns this data, pass this to them.
542   if (section->GetObjectFile() != this)
543     return section->GetObjectFile()->ReadSectionData(section, section_data);
544 
545   if (IsInMemory()) {
546     ProcessSP process_sp(m_process_wp.lock());
547     if (process_sp) {
548       const addr_t base_load_addr =
549           section->GetLoadBaseAddress(&process_sp->GetTarget());
550       if (base_load_addr != LLDB_INVALID_ADDRESS) {
551         DataBufferSP data_sp(
552             ReadMemory(process_sp, base_load_addr, section->GetByteSize()));
553         if (data_sp) {
554           section_data.SetData(data_sp, 0, data_sp->GetByteSize());
555           section_data.SetByteOrder(process_sp->GetByteOrder());
556           section_data.SetAddressByteSize(process_sp->GetAddressByteSize());
557           return section_data.GetByteSize();
558         }
559       }
560     }
561     return GetData(section->GetFileOffset(), section->GetFileSize(),
562                    section_data);
563   } else {
564     // The object file now contains a full mmap'ed copy of the object file
565     // data, so just use this
566     if (!section->IsRelocated())
567       RelocateSection(section);
568 
569     return GetData(section->GetFileOffset(), section->GetFileSize(),
570                    section_data);
571   }
572 }
573 
574 bool ObjectFile::SplitArchivePathWithObject(const char *path_with_object,
575                                             FileSpec &archive_file,
576                                             ConstString &archive_object,
577                                             bool must_exist) {
578   llvm::SmallVector<llvm::StringRef, 3> matches;
579   RegularExpression g_object_regex(llvm::StringRef("(.*)\\(([^\\)]+)\\)$"));
580   if (g_object_regex.Execute(llvm::StringRef::withNullAsEmpty(path_with_object),
581                              &matches)) {
582     std::string path = matches[1].str();
583     std::string obj = matches[2].str();
584     archive_file.SetFile(path, FileSpec::Style::native);
585     archive_object.SetCString(obj.c_str());
586     return !(must_exist && !FileSystem::Instance().Exists(archive_file));
587   }
588   return false;
589 }
590 
591 void ObjectFile::ClearSymtab() {
592   ModuleSP module_sp(GetModule());
593   if (module_sp) {
594     std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
595     Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
596     LLDB_LOGF(log, "%p ObjectFile::ClearSymtab () symtab = %p",
597               static_cast<void *>(this),
598               static_cast<void *>(m_symtab_up.get()));
599     m_symtab_up.reset();
600   }
601 }
602 
603 SectionList *ObjectFile::GetSectionList(bool update_module_section_list) {
604   if (m_sections_up == nullptr) {
605     if (update_module_section_list) {
606       ModuleSP module_sp(GetModule());
607       if (module_sp) {
608         std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
609         CreateSections(*module_sp->GetUnifiedSectionList());
610       }
611     } else {
612       SectionList unified_section_list;
613       CreateSections(unified_section_list);
614     }
615   }
616   return m_sections_up.get();
617 }
618 
619 lldb::SymbolType
620 ObjectFile::GetSymbolTypeFromName(llvm::StringRef name,
621                                   lldb::SymbolType symbol_type_hint) {
622   if (!name.empty()) {
623     if (name.startswith("_OBJC_")) {
624       // ObjC
625       if (name.startswith("_OBJC_CLASS_$_"))
626         return lldb::eSymbolTypeObjCClass;
627       if (name.startswith("_OBJC_METACLASS_$_"))
628         return lldb::eSymbolTypeObjCMetaClass;
629       if (name.startswith("_OBJC_IVAR_$_"))
630         return lldb::eSymbolTypeObjCIVar;
631     } else if (name.startswith(".objc_class_name_")) {
632       // ObjC v1
633       return lldb::eSymbolTypeObjCClass;
634     }
635   }
636   return symbol_type_hint;
637 }
638 
639 ConstString ObjectFile::GetNextSyntheticSymbolName() {
640   StreamString ss;
641   ConstString file_name = GetModule()->GetFileSpec().GetFilename();
642   ss.Printf("___lldb_unnamed_symbol%u$$%s", ++m_synthetic_symbol_idx,
643             file_name.GetCString());
644   return ConstString(ss.GetString());
645 }
646 
647 std::vector<ObjectFile::LoadableData>
648 ObjectFile::GetLoadableData(Target &target) {
649   std::vector<LoadableData> loadables;
650   SectionList *section_list = GetSectionList();
651   if (!section_list)
652     return loadables;
653   // Create a list of loadable data from loadable sections
654   size_t section_count = section_list->GetNumSections(0);
655   for (size_t i = 0; i < section_count; ++i) {
656     LoadableData loadable;
657     SectionSP section_sp = section_list->GetSectionAtIndex(i);
658     loadable.Dest =
659         target.GetSectionLoadList().GetSectionLoadAddress(section_sp);
660     if (loadable.Dest == LLDB_INVALID_ADDRESS)
661       continue;
662     // We can skip sections like bss
663     if (section_sp->GetFileSize() == 0)
664       continue;
665     DataExtractor section_data;
666     section_sp->GetSectionData(section_data);
667     loadable.Contents = llvm::ArrayRef<uint8_t>(section_data.GetDataStart(),
668                                                 section_data.GetByteSize());
669     loadables.push_back(loadable);
670   }
671   return loadables;
672 }
673 
674 void ObjectFile::RelocateSection(lldb_private::Section *section)
675 {
676 }
677 
678 DataBufferSP ObjectFile::MapFileData(const FileSpec &file, uint64_t Size,
679                                      uint64_t Offset) {
680   return FileSystem::Instance().CreateDataBuffer(file.GetPath(), Size, Offset);
681 }
682 
683 void llvm::format_provider<ObjectFile::Type>::format(
684     const ObjectFile::Type &type, raw_ostream &OS, StringRef Style) {
685   switch (type) {
686   case ObjectFile::eTypeInvalid:
687     OS << "invalid";
688     break;
689   case ObjectFile::eTypeCoreFile:
690     OS << "core file";
691     break;
692   case ObjectFile::eTypeExecutable:
693     OS << "executable";
694     break;
695   case ObjectFile::eTypeDebugInfo:
696     OS << "debug info";
697     break;
698   case ObjectFile::eTypeDynamicLinker:
699     OS << "dynamic linker";
700     break;
701   case ObjectFile::eTypeObjectFile:
702     OS << "object file";
703     break;
704   case ObjectFile::eTypeSharedLibrary:
705     OS << "shared library";
706     break;
707   case ObjectFile::eTypeStubLibrary:
708     OS << "stub library";
709     break;
710   case ObjectFile::eTypeJIT:
711     OS << "jit";
712     break;
713   case ObjectFile::eTypeUnknown:
714     OS << "unknown";
715     break;
716   }
717 }
718 
719 void llvm::format_provider<ObjectFile::Strata>::format(
720     const ObjectFile::Strata &strata, raw_ostream &OS, StringRef Style) {
721   switch (strata) {
722   case ObjectFile::eStrataInvalid:
723     OS << "invalid";
724     break;
725   case ObjectFile::eStrataUnknown:
726     OS << "unknown";
727     break;
728   case ObjectFile::eStrataUser:
729     OS << "user";
730     break;
731   case ObjectFile::eStrataKernel:
732     OS << "kernel";
733     break;
734   case ObjectFile::eStrataRawImage:
735     OS << "raw image";
736     break;
737   case ObjectFile::eStrataJIT:
738     OS << "jit";
739     break;
740   }
741 }
742