1//===-- AppleDWARFIndex.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 LLDB_SOURCE_PLUGINS_SYMBOLFILE_DWARF_APPLEDWARFINDEX_H 10#define LLDB_SOURCE_PLUGINS_SYMBOLFILE_DWARF_APPLEDWARFINDEX_H 11 12#include "Plugins/SymbolFile/DWARF/DWARFIndex.h" 13#include "llvm/DebugInfo/DWARF/DWARFAcceleratorTable.h" 14 15namespace lldb_private::plugin { 16namespace dwarf { 17class AppleDWARFIndex : public DWARFIndex { 18public: 19 static std::unique_ptr<AppleDWARFIndex> 20 Create(Module &module, DWARFDataExtractor apple_names, 21 DWARFDataExtractor apple_namespaces, DWARFDataExtractor apple_types, 22 DWARFDataExtractor apple_objc, DWARFDataExtractor debug_str); 23 24 AppleDWARFIndex(Module &module, 25 std::unique_ptr<llvm::AppleAcceleratorTable> apple_names, 26 std::unique_ptr<llvm::AppleAcceleratorTable> apple_namespaces, 27 std::unique_ptr<llvm::AppleAcceleratorTable> apple_types, 28 std::unique_ptr<llvm::AppleAcceleratorTable> apple_objc, 29 lldb::DataBufferSP apple_names_storage, 30 lldb::DataBufferSP apple_namespaces_storage, 31 lldb::DataBufferSP apple_types_storage, 32 lldb::DataBufferSP apple_objc_storage) 33 : DWARFIndex(module), m_apple_names_up(std::move(apple_names)), 34 m_apple_namespaces_up(std::move(apple_namespaces)), 35 m_apple_types_up(std::move(apple_types)), 36 m_apple_objc_up(std::move(apple_objc)), 37 m_apple_names_storage(apple_names_storage), 38 m_apple_namespaces_storage(apple_namespaces_storage), 39 m_apple_types_storage(apple_types_storage), 40 m_apple_objc_storage(apple_objc_storage) {} 41 42 void Preload() override {} 43 44 void 45 GetGlobalVariables(ConstString basename, 46 llvm::function_ref<bool(DWARFDIE die)> callback) override; 47 void 48 GetGlobalVariables(const RegularExpression ®ex, 49 llvm::function_ref<bool(DWARFDIE die)> callback) override; 50 void 51 GetGlobalVariables(DWARFUnit &cu, 52 llvm::function_ref<bool(DWARFDIE die)> callback) override; 53 void GetObjCMethods(ConstString class_name, 54 llvm::function_ref<bool(DWARFDIE die)> callback) override; 55 void GetCompleteObjCClass( 56 ConstString class_name, bool must_be_implementation, 57 llvm::function_ref<bool(DWARFDIE die)> callback) override; 58 void GetTypes(ConstString name, 59 llvm::function_ref<bool(DWARFDIE die)> callback) override; 60 void GetTypes(const DWARFDeclContext &context, 61 llvm::function_ref<bool(DWARFDIE die)> callback) override; 62 void GetNamespaces(ConstString name, 63 llvm::function_ref<bool(DWARFDIE die)> callback) override; 64 void GetFunctions(const Module::LookupInfo &lookup_info, 65 SymbolFileDWARF &dwarf, 66 const CompilerDeclContext &parent_decl_ctx, 67 llvm::function_ref<bool(DWARFDIE die)> callback) override; 68 void GetFunctions(const RegularExpression ®ex, 69 llvm::function_ref<bool(DWARFDIE die)> callback) override; 70 71 void Dump(Stream &s) override; 72 73private: 74 std::unique_ptr<llvm::AppleAcceleratorTable> m_apple_names_up; 75 std::unique_ptr<llvm::AppleAcceleratorTable> m_apple_namespaces_up; 76 std::unique_ptr<llvm::AppleAcceleratorTable> m_apple_types_up; 77 std::unique_ptr<llvm::AppleAcceleratorTable> m_apple_objc_up; 78 /// The following storage variables hold the data that the apple accelerator 79 /// tables tables above point to. 80 /// { 81 lldb::DataBufferSP m_apple_names_storage; 82 lldb::DataBufferSP m_apple_namespaces_storage; 83 lldb::DataBufferSP m_apple_types_storage; 84 lldb::DataBufferSP m_apple_objc_storage; 85 /// } 86 87 /// Search for entries whose name is `name` in `table`, calling `callback` for 88 /// each match. If `search_for_tag` is provided, ignore entries whose tag is 89 /// not `search_for_tag`. If `search_for_qualhash` is provided, ignore entries 90 /// whose qualified name hash does not match `search_for_qualhash`. 91 /// If `callback` returns false for an entry, the search is interrupted. 92 void SearchFor(const llvm::AppleAcceleratorTable &table, llvm::StringRef name, 93 llvm::function_ref<bool(DWARFDIE die)> callback, 94 std::optional<dw_tag_t> search_for_tag = std::nullopt, 95 std::optional<uint32_t> search_for_qualhash = std::nullopt); 96}; 97} // namespace dwarf 98} // namespace lldb_private::plugin 99 100#endif // LLDB_SOURCE_PLUGINS_SYMBOLFILE_DWARF_APPLEDWARFINDEX_H 101