1 //===-- RegisterUtilities.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_PROCESS_ELF_CORE_REGISTERUTILITIES_H 10 #define LLDB_SOURCE_PLUGINS_PROCESS_ELF_CORE_REGISTERUTILITIES_H 11 12 #include "Plugins/ObjectFile/ELF/ObjectFileELF.h" 13 #include "lldb/Utility/DataExtractor.h" 14 #include "llvm/BinaryFormat/ELF.h" 15 16 namespace lldb_private { 17 /// Core files PT_NOTE segment descriptor types 18 19 namespace NETBSD { 20 enum { NT_PROCINFO = 1, NT_AUXV = 2 }; 21 22 /* Size in bytes */ 23 enum { NT_PROCINFO_SIZE = 160 }; 24 25 /* Size in bytes */ 26 enum { 27 NT_PROCINFO_CPI_VERSION_SIZE = 4, 28 NT_PROCINFO_CPI_CPISIZE_SIZE = 4, 29 NT_PROCINFO_CPI_SIGNO_SIZE = 4, 30 NT_PROCINFO_CPI_SIGCODE_SIZE = 4, 31 NT_PROCINFO_CPI_SIGPEND_SIZE = 16, 32 NT_PROCINFO_CPI_SIGMASK_SIZE = 16, 33 NT_PROCINFO_CPI_SIGIGNORE_SIZE = 16, 34 NT_PROCINFO_CPI_SIGCATCH_SIZE = 16, 35 NT_PROCINFO_CPI_PID_SIZE = 4, 36 NT_PROCINFO_CPI_PPID_SIZE = 4, 37 NT_PROCINFO_CPI_PGRP_SIZE = 4, 38 NT_PROCINFO_CPI_SID_SIZE = 4, 39 NT_PROCINFO_CPI_RUID_SIZE = 4, 40 NT_PROCINFO_CPI_EUID_SIZE = 4, 41 NT_PROCINFO_CPI_SVUID_SIZE = 4, 42 NT_PROCINFO_CPI_RGID_SIZE = 4, 43 NT_PROCINFO_CPI_EGID_SIZE = 4, 44 NT_PROCINFO_CPI_SVGID_SIZE = 4, 45 NT_PROCINFO_CPI_NLWPS_SIZE = 4, 46 NT_PROCINFO_CPI_NAME_SIZE = 32, 47 NT_PROCINFO_CPI_SIGLWP_SIZE = 4, 48 }; 49 50 namespace AARCH64 { 51 enum { NT_REGS = 32, NT_FPREGS = 34 }; 52 } 53 54 namespace AMD64 { 55 enum { NT_REGS = 33, NT_FPREGS = 35 }; 56 } 57 58 namespace I386 { 59 enum { NT_REGS = 33, NT_FPREGS = 35 }; 60 } 61 62 } // namespace NETBSD 63 64 namespace OPENBSD { 65 enum { 66 NT_PROCINFO = 10, 67 NT_AUXV = 11, 68 NT_REGS = 20, 69 NT_FPREGS = 21, 70 NT_PACMASK = 24, 71 }; 72 } 73 74 struct CoreNote { 75 ELFNote info; 76 DataExtractor data; 77 }; 78 79 // A structure describing how to find a register set in a core file from a given 80 // OS. 81 struct RegsetDesc { 82 // OS to which this entry applies to. Must not be UnknownOS. 83 llvm::Triple::OSType OS; 84 85 // Architecture to which this entry applies to. Can be UnknownArch, in which 86 // case it applies to all architectures of a given OS. 87 llvm::Triple::ArchType Arch; 88 89 // The note type under which the register set can be found. 90 uint32_t Note; 91 }; 92 93 // Returns the register set in Notes which corresponds to the specified Triple 94 // according to the list of register set descriptions in RegsetDescs. The list 95 // is scanned linearly, so you can use a more specific entry (e.g. linux-i386) 96 // to override a more general entry (e.g. general linux), as long as you place 97 // it earlier in the list. If a register set is not found, it returns an empty 98 // DataExtractor. 99 DataExtractor getRegset(llvm::ArrayRef<CoreNote> Notes, 100 const llvm::Triple &Triple, 101 llvm::ArrayRef<RegsetDesc> RegsetDescs); 102 103 constexpr RegsetDesc FPR_Desc[] = { 104 // FreeBSD/i386 core NT_FPREGSET is x87 FSAVE result but the XSAVE dump 105 // starts with FXSAVE struct, so use that instead if available. 106 {llvm::Triple::FreeBSD, llvm::Triple::x86, llvm::ELF::NT_X86_XSTATE}, 107 {llvm::Triple::FreeBSD, llvm::Triple::UnknownArch, llvm::ELF::NT_FPREGSET}, 108 // In a i386 core file NT_FPREGSET is present, but it's not the result 109 // of the FXSAVE instruction like in 64 bit files. 110 // The result from FXSAVE is in NT_PRXFPREG for i386 core files 111 {llvm::Triple::Linux, llvm::Triple::x86, llvm::ELF::NT_PRXFPREG}, 112 {llvm::Triple::Linux, llvm::Triple::UnknownArch, llvm::ELF::NT_FPREGSET}, 113 {llvm::Triple::NetBSD, llvm::Triple::aarch64, NETBSD::AARCH64::NT_FPREGS}, 114 {llvm::Triple::NetBSD, llvm::Triple::x86, NETBSD::I386::NT_FPREGS}, 115 {llvm::Triple::NetBSD, llvm::Triple::x86_64, NETBSD::AMD64::NT_FPREGS}, 116 {llvm::Triple::OpenBSD, llvm::Triple::UnknownArch, OPENBSD::NT_FPREGS}, 117 }; 118 119 constexpr RegsetDesc AARCH64_SVE_Desc[] = { 120 {llvm::Triple::Linux, llvm::Triple::aarch64, llvm::ELF::NT_ARM_SVE}, 121 }; 122 123 constexpr RegsetDesc AARCH64_PAC_Desc[] = { 124 {llvm::Triple::Linux, llvm::Triple::aarch64, llvm::ELF::NT_ARM_PAC_MASK}, 125 {llvm::Triple::OpenBSD, llvm::Triple::aarch64, OPENBSD::NT_PACMASK}, 126 }; 127 128 constexpr RegsetDesc PPC_VMX_Desc[] = { 129 {llvm::Triple::FreeBSD, llvm::Triple::UnknownArch, llvm::ELF::NT_PPC_VMX}, 130 {llvm::Triple::Linux, llvm::Triple::UnknownArch, llvm::ELF::NT_PPC_VMX}, 131 }; 132 133 constexpr RegsetDesc PPC_VSX_Desc[] = { 134 {llvm::Triple::Linux, llvm::Triple::UnknownArch, llvm::ELF::NT_PPC_VSX}, 135 }; 136 137 } // namespace lldb_private 138 139 #endif // LLDB_SOURCE_PLUGINS_PROCESS_ELF_CORE_REGISTERUTILITIES_H 140