LLDB mainline
NativeRegisterContextLinux_arm64.h
Go to the documentation of this file.
1//===-- NativeRegisterContextLinux_arm64.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#if defined(__arm64__) || defined(__aarch64__)
10
11#ifndef lldb_NativeRegisterContextLinux_arm64_h
12#define lldb_NativeRegisterContextLinux_arm64_h
13
18
19#include <asm/ptrace.h>
20
21namespace lldb_private {
22namespace process_linux {
23
25
26class NativeRegisterContextLinux_arm64
28 public NativeRegisterContextDBReg_arm64 {
29public:
30 NativeRegisterContextLinux_arm64(
31 const ArchSpec &target_arch, NativeThreadProtocol &native_thread,
32 std::unique_ptr<RegisterInfoPOSIX_arm64> register_info_up);
33
34 uint32_t GetRegisterSetCount() const override;
35
36 uint32_t GetUserRegisterCount() const override;
37
38 const RegisterSet *GetRegisterSet(uint32_t set_index) const override;
39
40 Status ReadRegister(const RegisterInfo *reg_info,
41 RegisterValue &reg_value) override;
42
43 Status WriteRegister(const RegisterInfo *reg_info,
44 const RegisterValue &reg_value) override;
45
46 Status ReadAllRegisterValues(lldb::WritableDataBufferSP &data_sp) override;
47
48 Status WriteAllRegisterValues(const lldb::DataBufferSP &data_sp) override;
49
50 void InvalidateAllRegisters() override;
51
52 std::vector<uint32_t>
53 GetExpeditedRegisters(ExpeditedRegs expType) const override;
54
55 bool RegisterOffsetIsDynamic() const override { return true; }
56
57 llvm::Expected<MemoryTaggingDetails>
58 GetMemoryTaggingDetails(int32_t type) override;
59
60protected:
61 Status ReadGPR() override;
62
63 Status WriteGPR() override;
64
65 Status ReadFPR() override;
66
67 Status WriteFPR() override;
68
69 void *GetGPRBuffer() override { return &m_gpr_arm64; }
70
71 // GetGPRBufferSize returns sizeof arm64 GPR ptrace buffer, it is different
72 // from GetGPRSize which returns sizeof RegisterInfoPOSIX_arm64::GPR.
73 size_t GetGPRBufferSize() { return sizeof(m_gpr_arm64); }
74
75 void *GetFPRBuffer() override { return &m_fpr; }
76
77 size_t GetFPRSize() override { return sizeof(m_fpr); }
78
79 lldb::addr_t FixWatchpointHitAddress(lldb::addr_t hit_addr) override;
80
81private:
82 bool m_gpr_is_valid;
83 bool m_fpu_is_valid;
84 bool m_sve_buffer_is_valid;
85 bool m_mte_ctrl_is_valid;
86 bool m_zt_buffer_is_valid;
87 bool m_fpmr_is_valid;
88
89 bool m_sve_header_is_valid;
90 bool m_za_buffer_is_valid;
91 bool m_za_header_is_valid;
92 bool m_pac_mask_is_valid;
93 bool m_tls_is_valid;
94 size_t m_tls_size = 0;
95 bool m_gcs_is_valid;
96 bool m_poe_is_valid;
97
98 /// 64-bit general purpose registers.
99 struct user_pt_regs m_gpr_arm64{};
100
101 /// Floating-point registers including extended register sets.
102 RegisterInfoPOSIX_arm64::FPU m_fpr{};
103
104 SVEState m_sve_state = SVEState::Unknown;
105 struct sve::user_sve_header m_sve_header{};
106 std::vector<uint8_t> m_sve_ptrace_payload;
107
108 sve::user_za_header m_za_header;
109 std::vector<uint8_t> m_za_ptrace_payload;
110
111 bool m_refresh_hwdebug_info = true;
112
113 struct user_pac_mask {
114 uint64_t data_mask = 0;
115 uint64_t insn_mask = 0;
116 } m_pac_mask;
117
118 uint64_t m_mte_ctrl_reg = 0;
119
120 struct sme_pseudo_regs {
121 uint64_t ctrl_reg = 0;
122 uint64_t svg_reg = 0;
123 } m_sme_pseudo_regs;
124
125 struct tls_regs {
126 uint64_t tpidr_reg = 0;
127 // Only valid when SME is present.
128 uint64_t tpidr2_reg = 0;
129 } m_tls_regs;
130
131 // SME2's ZT is a 512 bit register.
132 std::array<uint8_t, 64> m_zt_reg{};
133
134 uint64_t m_fpmr_reg = 0;
135
136 struct poe_regs {
137 uint64_t por_el0_reg = 0;
138 } m_poe_regs;
139
140 struct gcs_regs {
141 uint64_t features_enabled = 0;
142 uint64_t features_locked = 0;
143 uint64_t gcspr_e0 = 0;
144 } m_gcs_regs;
145
146 Status ReadAllSVE();
147
148 Status WriteAllSVE();
149
150 Status ReadSVEHeader();
151
152 Status WriteSVEHeader();
153
154 Status ReadPAuthMask();
155
156 Status ReadMTEControl();
157
158 Status WriteMTEControl();
159
160 Status ReadTLS();
161
162 Status WriteTLS();
163
164 Status ReadSMESVG();
165
166 Status ReadZAHeader();
167
168 Status ReadZA();
169
170 Status WriteZA();
171
172 Status ReadGCS();
173
174 Status WriteGCS();
175
176 // No WriteZAHeader because writing only the header will disable ZA.
177 // Instead use WriteZA and ensure you have the correct ZA buffer size set
178 // beforehand if you wish to disable it.
179
180 Status ReadZT();
181
182 Status WriteZT();
183
184 // SVCR is a pseudo register and we do not allow writes to it.
185 Status ReadSMEControl();
186
187 Status ReadFPMR();
188
189 Status WriteFPMR();
190
191 Status ReadPOE();
192
193 Status WritePOE();
194
195 uint64_t GetSVERegVG() { return m_sve_header.vl / 8; }
196
197 void SetSVERegVG(uint64_t vg) { m_sve_header.vl = vg * 8; }
198
199 void *GetSVEHeader() { return &m_sve_header; }
200
201 void *GetZAHeader() { return &m_za_header; }
202
203 size_t GetZAHeaderSize() { return sizeof(m_za_header); }
204
205 void *GetPACMask() { return &m_pac_mask; }
206
207 void *GetMTEControl() { return &m_mte_ctrl_reg; }
208
209 void *GetTLSBuffer() { return &m_tls_regs; }
210
211 void *GetSMEPseudoBuffer() { return &m_sme_pseudo_regs; }
212
213 void *GetZTBuffer() { return m_zt_reg.data(); }
214
215 void *GetSVEBuffer() { return m_sve_ptrace_payload.data(); }
216
217 void *GetFPMRBuffer() { return &m_fpmr_reg; }
218
219 void *GetGCSBuffer() { return &m_gcs_regs; }
220
221 void *GetPOEBuffer() { return &m_poe_regs; }
222
223 size_t GetSVEHeaderSize() { return sizeof(m_sve_header); }
224
225 size_t GetPACMaskSize() { return sizeof(m_pac_mask); }
226
227 size_t GetSVEBufferSize() { return m_sve_ptrace_payload.size(); }
228
229 unsigned GetSVERegSet();
230
231 void *GetZABuffer() { return m_za_ptrace_payload.data(); };
232
233 size_t GetZABufferSize() { return m_za_ptrace_payload.size(); }
234
235 size_t GetMTEControlSize() { return sizeof(m_mte_ctrl_reg); }
236
237 size_t GetTLSBufferSize() { return m_tls_size; }
238
239 size_t GetSMEPseudoBufferSize() { return sizeof(m_sme_pseudo_regs); }
240
241 size_t GetZTBufferSize() { return m_zt_reg.size(); }
242
243 size_t GetFPMRBufferSize() { return sizeof(m_fpmr_reg); }
244
245 size_t GetGCSBufferSize() { return sizeof(m_gcs_regs); }
246
247 size_t GetPOEBufferSize() { return sizeof(m_poe_regs); }
248
249 llvm::Error ReadHardwareDebugInfo() override;
250
251 llvm::Error WriteHardwareDebugRegs(DREGType hwbType) override;
252
253 uint32_t CalculateFprOffset(const RegisterInfo *reg_info,
254 bool streaming_fpsimd) const;
255
256 RegisterInfoPOSIX_arm64 &GetRegisterInfo() const;
257
258 void ConfigureRegisterContext();
259
260 uint32_t CalculateSVEOffset(const RegisterInfo *reg_info) const;
261
262 Status CacheAllRegisters(uint32_t &cached_size);
263};
264
265} // namespace process_linux
266} // namespace lldb_private
267
268#endif // #ifndef lldb_NativeRegisterContextLinux_arm64_h
269
270#endif // defined (__arm64__) || defined (__aarch64__)
Manages communication with the inferior (debugee) process.
Status WriteHardwareDebugRegs(int hwbType, ::pid_t tid, uint32_t max_supported, const std::array< NativeRegisterContextDBReg::DREG, 16 > &regs)
Status ReadHardwareDebugInfo(::pid_t tid, uint32_t &max_hwp_supported, uint32_t &max_hbp_supported)
A class that represents a running process on the host machine.
std::shared_ptr< lldb_private::DataBuffer > DataBufferSP
std::shared_ptr< lldb_private::WritableDataBuffer > WritableDataBufferSP
uint64_t addr_t
Definition lldb-types.h:80