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
17namespace 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.
22class NativeProcessELF : public NativeProcessProtocol {
23  using NativeProcessProtocol::NativeProcessProtocol;
24
25public:
26  std::optional<uint64_t> GetAuxValue(enum AuxVector::EntryType type);
27
28protected:
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.
58extern template lldb::addr_t NativeProcessELF::GetELFImageInfoAddress<
59    llvm::ELF::Elf32_Ehdr, llvm::ELF::Elf32_Phdr, llvm::ELF::Elf32_Dyn>();
60extern 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