1 //===-- NativeProcessELF.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_NativeProcessELF_H_
10 #define liblldb_NativeProcessELF_H_
11 
12 #include "Plugins/Process/Utility/AuxVector.h"
13 #include "lldb/Host/common/NativeProcessProtocol.h"
14 #include "llvm/BinaryFormat/ELF.h"
15 #include <optional>
16 
17 namespace lldb_private {
18 
19 /// \class NativeProcessELF
20 /// Abstract class that extends \a NativeProcessProtocol with ELF specific
21 /// logic. Meant to be subclassed by ELF based NativeProcess* implementations.
22 class NativeProcessELF : public NativeProcessProtocol {
23   using NativeProcessProtocol::NativeProcessProtocol;
24 
25 public:
26   std::optional<uint64_t> GetAuxValue(enum AuxVector::EntryType type);
27 
28 protected:
29   template <typename T> struct ELFLinkMap {
30     T l_addr;
31     T l_name;
32     T l_ld;
33     T l_next;
34     T l_prev;
35   };
36 
37   lldb::addr_t GetSharedLibraryInfoAddress() override;
38 
39   template <typename ELF_EHDR, typename ELF_PHDR, typename ELF_DYN>
40   lldb::addr_t GetELFImageInfoAddress();
41 
42   llvm::Expected<std::vector<SVR4LibraryInfo>>
43   GetLoadedSVR4Libraries() override;
44 
45   template <typename T>
46   llvm::Expected<SVR4LibraryInfo>
47   ReadSVR4LibraryInfo(lldb::addr_t link_map_addr);
48 
49   void NotifyDidExec() override;
50 
51   std::unique_ptr<AuxVector> m_aux_vector;
52   std::optional<lldb::addr_t> m_shared_library_info_addr;
53 };
54 
55 // Explicitly declare the two 32/64 bit templates that NativeProcessELF.cpp will
56 // define. This allows us to keep the template definition here and usable
57 // elsewhere.
58 extern template lldb::addr_t NativeProcessELF::GetELFImageInfoAddress<
59     llvm::ELF::Elf32_Ehdr, llvm::ELF::Elf32_Phdr, llvm::ELF::Elf32_Dyn>();
60 extern template lldb::addr_t NativeProcessELF::GetELFImageInfoAddress<
61     llvm::ELF::Elf64_Ehdr, llvm::ELF::Elf64_Phdr, llvm::ELF::Elf64_Dyn>();
62 
63 } // namespace lldb_private
64 
65 #endif
66