qga/qapi-schema: Refill doc comments to conform to current conventions
[qemu/kevin.git] / target / arm / gdbstub.c
bloba3bb73cfa7ce465fc6706f5a2a7a7d6470c77db3
1 /*
2 * ARM gdb server stub
4 * Copyright (c) 2003-2005 Fabrice Bellard
5 * Copyright (c) 2013 SUSE LINUX Products GmbH
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
20 #include "qemu/osdep.h"
21 #include "cpu.h"
22 #include "exec/gdbstub.h"
23 #include "gdbstub/helpers.h"
24 #include "sysemu/tcg.h"
25 #include "internals.h"
26 #include "cpu-features.h"
27 #include "cpregs.h"
29 typedef struct RegisterSysregFeatureParam {
30 CPUState *cs;
31 GDBFeatureBuilder builder;
32 int n;
33 } RegisterSysregFeatureParam;
35 /* Old gdb always expect FPA registers. Newer (xml-aware) gdb only expect
36 whatever the target description contains. Due to a historical mishap
37 the FPA registers appear in between core integer regs and the CPSR.
38 We hack round this by giving the FPA regs zero size when talking to a
39 newer gdb. */
41 int arm_cpu_gdb_read_register(CPUState *cs, GByteArray *mem_buf, int n)
43 ARMCPU *cpu = ARM_CPU(cs);
44 CPUARMState *env = &cpu->env;
46 if (n < 16) {
47 /* Core integer register. */
48 return gdb_get_reg32(mem_buf, env->regs[n]);
50 if (n == 25) {
51 /* CPSR, or XPSR for M-profile */
52 if (arm_feature(env, ARM_FEATURE_M)) {
53 return gdb_get_reg32(mem_buf, xpsr_read(env));
54 } else {
55 return gdb_get_reg32(mem_buf, cpsr_read(env));
58 /* Unknown register. */
59 return 0;
62 int arm_cpu_gdb_write_register(CPUState *cs, uint8_t *mem_buf, int n)
64 ARMCPU *cpu = ARM_CPU(cs);
65 CPUARMState *env = &cpu->env;
66 uint32_t tmp;
68 tmp = ldl_p(mem_buf);
71 * Mask out low bits of PC to workaround gdb bugs.
72 * This avoids an assert in thumb_tr_translate_insn, because it is
73 * architecturally impossible to misalign the pc.
74 * This will probably cause problems if we ever implement the
75 * Jazelle DBX extensions.
77 if (n == 15) {
78 tmp &= ~1;
81 if (n < 16) {
82 /* Core integer register. */
83 if (n == 13 && arm_feature(env, ARM_FEATURE_M)) {
84 /* M profile SP low bits are always 0 */
85 tmp &= ~3;
87 env->regs[n] = tmp;
88 return 4;
90 if (n == 25) {
91 /* CPSR, or XPSR for M-profile */
92 if (arm_feature(env, ARM_FEATURE_M)) {
94 * Don't allow writing to XPSR.Exception as it can cause
95 * a transition into or out of handler mode (it's not
96 * writable via the MSR insn so this is a reasonable
97 * restriction). Other fields are safe to update.
99 xpsr_write(env, tmp, ~XPSR_EXCP);
100 } else {
101 cpsr_write(env, tmp, 0xffffffff, CPSRWriteByGDBStub);
103 return 4;
105 /* Unknown register. */
106 return 0;
109 static int vfp_gdb_get_reg(CPUState *cs, GByteArray *buf, int reg)
111 ARMCPU *cpu = ARM_CPU(cs);
112 CPUARMState *env = &cpu->env;
113 int nregs = cpu_isar_feature(aa32_simd_r32, cpu) ? 32 : 16;
115 /* VFP data registers are always little-endian. */
116 if (reg < nregs) {
117 return gdb_get_reg64(buf, *aa32_vfp_dreg(env, reg));
119 if (arm_feature(env, ARM_FEATURE_NEON)) {
120 /* Aliases for Q regs. */
121 nregs += 16;
122 if (reg < nregs) {
123 uint64_t *q = aa32_vfp_qreg(env, reg - 32);
124 return gdb_get_reg128(buf, q[0], q[1]);
127 switch (reg - nregs) {
128 case 0:
129 return gdb_get_reg32(buf, vfp_get_fpscr(env));
131 return 0;
134 static int vfp_gdb_set_reg(CPUState *cs, uint8_t *buf, int reg)
136 ARMCPU *cpu = ARM_CPU(cs);
137 CPUARMState *env = &cpu->env;
138 int nregs = cpu_isar_feature(aa32_simd_r32, cpu) ? 32 : 16;
140 if (reg < nregs) {
141 *aa32_vfp_dreg(env, reg) = ldq_le_p(buf);
142 return 8;
144 if (arm_feature(env, ARM_FEATURE_NEON)) {
145 nregs += 16;
146 if (reg < nregs) {
147 uint64_t *q = aa32_vfp_qreg(env, reg - 32);
148 q[0] = ldq_le_p(buf);
149 q[1] = ldq_le_p(buf + 8);
150 return 16;
153 switch (reg - nregs) {
154 case 0:
155 vfp_set_fpscr(env, ldl_p(buf));
156 return 4;
158 return 0;
161 static int vfp_gdb_get_sysreg(CPUState *cs, GByteArray *buf, int reg)
163 ARMCPU *cpu = ARM_CPU(cs);
164 CPUARMState *env = &cpu->env;
166 switch (reg) {
167 case 0:
168 return gdb_get_reg32(buf, env->vfp.xregs[ARM_VFP_FPSID]);
169 case 1:
170 return gdb_get_reg32(buf, env->vfp.xregs[ARM_VFP_FPEXC]);
172 return 0;
175 static int vfp_gdb_set_sysreg(CPUState *cs, uint8_t *buf, int reg)
177 ARMCPU *cpu = ARM_CPU(cs);
178 CPUARMState *env = &cpu->env;
180 switch (reg) {
181 case 0:
182 env->vfp.xregs[ARM_VFP_FPSID] = ldl_p(buf);
183 return 4;
184 case 1:
185 env->vfp.xregs[ARM_VFP_FPEXC] = ldl_p(buf) & (1 << 30);
186 return 4;
188 return 0;
191 static int mve_gdb_get_reg(CPUState *cs, GByteArray *buf, int reg)
193 ARMCPU *cpu = ARM_CPU(cs);
194 CPUARMState *env = &cpu->env;
196 switch (reg) {
197 case 0:
198 return gdb_get_reg32(buf, env->v7m.vpr);
199 default:
200 return 0;
204 static int mve_gdb_set_reg(CPUState *cs, uint8_t *buf, int reg)
206 ARMCPU *cpu = ARM_CPU(cs);
207 CPUARMState *env = &cpu->env;
209 switch (reg) {
210 case 0:
211 env->v7m.vpr = ldl_p(buf);
212 return 4;
213 default:
214 return 0;
219 * arm_get/set_gdb_*: get/set a gdb register
220 * @env: the CPU state
221 * @buf: a buffer to copy to/from
222 * @reg: register number (offset from start of group)
224 * We return the number of bytes copied
227 static int arm_gdb_get_sysreg(CPUState *cs, GByteArray *buf, int reg)
229 ARMCPU *cpu = ARM_CPU(cs);
230 CPUARMState *env = &cpu->env;
231 const ARMCPRegInfo *ri;
232 uint32_t key;
234 key = cpu->dyn_sysreg_feature.data.cpregs.keys[reg];
235 ri = get_arm_cp_reginfo(cpu->cp_regs, key);
236 if (ri) {
237 if (cpreg_field_is_64bit(ri)) {
238 return gdb_get_reg64(buf, (uint64_t)read_raw_cp_reg(env, ri));
239 } else {
240 return gdb_get_reg32(buf, (uint32_t)read_raw_cp_reg(env, ri));
243 return 0;
246 static int arm_gdb_set_sysreg(CPUState *cs, uint8_t *buf, int reg)
248 return 0;
251 static void arm_gen_one_feature_sysreg(GDBFeatureBuilder *builder,
252 DynamicGDBFeatureInfo *dyn_feature,
253 ARMCPRegInfo *ri, uint32_t ri_key,
254 int bitsize, int n)
256 gdb_feature_builder_append_reg(builder, ri->name, bitsize, n,
257 "int", "cp_regs");
259 dyn_feature->data.cpregs.keys[n] = ri_key;
262 static void arm_register_sysreg_for_feature(gpointer key, gpointer value,
263 gpointer p)
265 uint32_t ri_key = (uintptr_t)key;
266 ARMCPRegInfo *ri = value;
267 RegisterSysregFeatureParam *param = p;
268 ARMCPU *cpu = ARM_CPU(param->cs);
269 CPUARMState *env = &cpu->env;
270 DynamicGDBFeatureInfo *dyn_feature = &cpu->dyn_sysreg_feature;
272 if (!(ri->type & (ARM_CP_NO_RAW | ARM_CP_NO_GDB))) {
273 if (arm_feature(env, ARM_FEATURE_AARCH64)) {
274 if (ri->state == ARM_CP_STATE_AA64) {
275 arm_gen_one_feature_sysreg(&param->builder, dyn_feature,
276 ri, ri_key, 64, param->n++);
278 } else {
279 if (ri->state == ARM_CP_STATE_AA32) {
280 if (!arm_feature(env, ARM_FEATURE_EL3) &&
281 (ri->secure & ARM_CP_SECSTATE_S)) {
282 return;
284 if (ri->type & ARM_CP_64BIT) {
285 arm_gen_one_feature_sysreg(&param->builder, dyn_feature,
286 ri, ri_key, 64, param->n++);
287 } else {
288 arm_gen_one_feature_sysreg(&param->builder, dyn_feature,
289 ri, ri_key, 32, param->n++);
296 static GDBFeature *arm_gen_dynamic_sysreg_feature(CPUState *cs, int base_reg)
298 ARMCPU *cpu = ARM_CPU(cs);
299 RegisterSysregFeatureParam param = {cs};
300 gsize num_regs = g_hash_table_size(cpu->cp_regs);
302 gdb_feature_builder_init(&param.builder,
303 &cpu->dyn_sysreg_feature.desc,
304 "org.qemu.gdb.arm.sys.regs",
305 "system-registers.xml",
306 base_reg);
307 cpu->dyn_sysreg_feature.data.cpregs.keys = g_new(uint32_t, num_regs);
308 g_hash_table_foreach(cpu->cp_regs, arm_register_sysreg_for_feature, &param);
309 gdb_feature_builder_end(&param.builder);
310 return &cpu->dyn_sysreg_feature.desc;
313 #ifdef CONFIG_TCG
314 typedef enum {
315 M_SYSREG_MSP,
316 M_SYSREG_PSP,
317 M_SYSREG_PRIMASK,
318 M_SYSREG_CONTROL,
319 M_SYSREG_BASEPRI,
320 M_SYSREG_FAULTMASK,
321 M_SYSREG_MSPLIM,
322 M_SYSREG_PSPLIM,
323 } MProfileSysreg;
325 static const struct {
326 const char *name;
327 int feature;
328 } m_sysreg_def[] = {
329 [M_SYSREG_MSP] = { "msp", ARM_FEATURE_M },
330 [M_SYSREG_PSP] = { "psp", ARM_FEATURE_M },
331 [M_SYSREG_PRIMASK] = { "primask", ARM_FEATURE_M },
332 [M_SYSREG_CONTROL] = { "control", ARM_FEATURE_M },
333 [M_SYSREG_BASEPRI] = { "basepri", ARM_FEATURE_M_MAIN },
334 [M_SYSREG_FAULTMASK] = { "faultmask", ARM_FEATURE_M_MAIN },
335 [M_SYSREG_MSPLIM] = { "msplim", ARM_FEATURE_V8 },
336 [M_SYSREG_PSPLIM] = { "psplim", ARM_FEATURE_V8 },
339 static uint32_t *m_sysreg_ptr(CPUARMState *env, MProfileSysreg reg, bool sec)
341 uint32_t *ptr;
343 switch (reg) {
344 case M_SYSREG_MSP:
345 ptr = arm_v7m_get_sp_ptr(env, sec, false, true);
346 break;
347 case M_SYSREG_PSP:
348 ptr = arm_v7m_get_sp_ptr(env, sec, true, true);
349 break;
350 case M_SYSREG_MSPLIM:
351 ptr = &env->v7m.msplim[sec];
352 break;
353 case M_SYSREG_PSPLIM:
354 ptr = &env->v7m.psplim[sec];
355 break;
356 case M_SYSREG_PRIMASK:
357 ptr = &env->v7m.primask[sec];
358 break;
359 case M_SYSREG_BASEPRI:
360 ptr = &env->v7m.basepri[sec];
361 break;
362 case M_SYSREG_FAULTMASK:
363 ptr = &env->v7m.faultmask[sec];
364 break;
365 case M_SYSREG_CONTROL:
366 ptr = &env->v7m.control[sec];
367 break;
368 default:
369 return NULL;
371 return arm_feature(env, m_sysreg_def[reg].feature) ? ptr : NULL;
374 static int m_sysreg_get(CPUARMState *env, GByteArray *buf,
375 MProfileSysreg reg, bool secure)
377 uint32_t *ptr = m_sysreg_ptr(env, reg, secure);
379 if (ptr == NULL) {
380 return 0;
382 return gdb_get_reg32(buf, *ptr);
385 static int arm_gdb_get_m_systemreg(CPUState *cs, GByteArray *buf, int reg)
387 ARMCPU *cpu = ARM_CPU(cs);
388 CPUARMState *env = &cpu->env;
391 * Here, we emulate MRS instruction, where CONTROL has a mix of
392 * banked and non-banked bits.
394 if (reg == M_SYSREG_CONTROL) {
395 return gdb_get_reg32(buf, arm_v7m_mrs_control(env, env->v7m.secure));
397 return m_sysreg_get(env, buf, reg, env->v7m.secure);
400 static int arm_gdb_set_m_systemreg(CPUState *cs, uint8_t *buf, int reg)
402 return 0; /* TODO */
405 static GDBFeature *arm_gen_dynamic_m_systemreg_feature(CPUState *cs,
406 int base_reg)
408 ARMCPU *cpu = ARM_CPU(cs);
409 CPUARMState *env = &cpu->env;
410 GDBFeatureBuilder builder;
411 int reg = 0;
412 int i;
414 gdb_feature_builder_init(&builder, &cpu->dyn_m_systemreg_feature.desc,
415 "org.gnu.gdb.arm.m-system", "arm-m-system.xml",
416 base_reg);
418 for (i = 0; i < ARRAY_SIZE(m_sysreg_def); i++) {
419 if (arm_feature(env, m_sysreg_def[i].feature)) {
420 gdb_feature_builder_append_reg(&builder, m_sysreg_def[i].name, 32,
421 reg++, "int", NULL);
425 gdb_feature_builder_end(&builder);
427 return &cpu->dyn_m_systemreg_feature.desc;
430 #ifndef CONFIG_USER_ONLY
432 * For user-only, we see the non-secure registers via m_systemreg above.
433 * For secext, encode the non-secure view as even and secure view as odd.
435 static int arm_gdb_get_m_secextreg(CPUState *cs, GByteArray *buf, int reg)
437 ARMCPU *cpu = ARM_CPU(cs);
438 CPUARMState *env = &cpu->env;
440 return m_sysreg_get(env, buf, reg >> 1, reg & 1);
443 static int arm_gdb_set_m_secextreg(CPUState *cs, uint8_t *buf, int reg)
445 return 0; /* TODO */
448 static GDBFeature *arm_gen_dynamic_m_secextreg_feature(CPUState *cs,
449 int base_reg)
451 ARMCPU *cpu = ARM_CPU(cs);
452 GDBFeatureBuilder builder;
453 char *name;
454 int reg = 0;
455 int i;
457 gdb_feature_builder_init(&builder, &cpu->dyn_m_secextreg_feature.desc,
458 "org.gnu.gdb.arm.secext", "arm-m-secext.xml",
459 base_reg);
461 for (i = 0; i < ARRAY_SIZE(m_sysreg_def); i++) {
462 name = g_strconcat(m_sysreg_def[i].name, "_ns", NULL);
463 gdb_feature_builder_append_reg(&builder, name, 32, reg++,
464 "int", NULL);
465 name = g_strconcat(m_sysreg_def[i].name, "_s", NULL);
466 gdb_feature_builder_append_reg(&builder, name, 32, reg++,
467 "int", NULL);
470 gdb_feature_builder_end(&builder);
472 return &cpu->dyn_m_secextreg_feature.desc;
474 #endif
475 #endif /* CONFIG_TCG */
477 void arm_cpu_register_gdb_regs_for_features(ARMCPU *cpu)
479 CPUState *cs = CPU(cpu);
480 CPUARMState *env = &cpu->env;
482 if (arm_feature(env, ARM_FEATURE_AARCH64)) {
484 * The lower part of each SVE register aliases to the FPU
485 * registers so we don't need to include both.
487 #ifdef TARGET_AARCH64
488 if (isar_feature_aa64_sve(&cpu->isar)) {
489 GDBFeature *feature = arm_gen_dynamic_svereg_feature(cs, cs->gdb_num_regs);
490 gdb_register_coprocessor(cs, aarch64_gdb_get_sve_reg,
491 aarch64_gdb_set_sve_reg, feature, 0);
492 } else {
493 gdb_register_coprocessor(cs, aarch64_gdb_get_fpu_reg,
494 aarch64_gdb_set_fpu_reg,
495 gdb_find_static_feature("aarch64-fpu.xml"),
499 * Note that we report pauth information via the feature name
500 * org.gnu.gdb.aarch64.pauth_v2, not org.gnu.gdb.aarch64.pauth.
501 * GDB versions 9 through 12 have a bug where they will crash
502 * if they see the latter XML from QEMU.
504 if (isar_feature_aa64_pauth(&cpu->isar)) {
505 gdb_register_coprocessor(cs, aarch64_gdb_get_pauth_reg,
506 aarch64_gdb_set_pauth_reg,
507 gdb_find_static_feature("aarch64-pauth.xml"),
510 #endif
511 } else {
512 if (arm_feature(env, ARM_FEATURE_NEON)) {
513 gdb_register_coprocessor(cs, vfp_gdb_get_reg, vfp_gdb_set_reg,
514 gdb_find_static_feature("arm-neon.xml"),
516 } else if (cpu_isar_feature(aa32_simd_r32, cpu)) {
517 gdb_register_coprocessor(cs, vfp_gdb_get_reg, vfp_gdb_set_reg,
518 gdb_find_static_feature("arm-vfp3.xml"),
520 } else if (cpu_isar_feature(aa32_vfp_simd, cpu)) {
521 gdb_register_coprocessor(cs, vfp_gdb_get_reg, vfp_gdb_set_reg,
522 gdb_find_static_feature("arm-vfp.xml"), 0);
524 if (!arm_feature(env, ARM_FEATURE_M)) {
526 * A and R profile have FP sysregs FPEXC and FPSID that we
527 * expose to gdb.
529 gdb_register_coprocessor(cs, vfp_gdb_get_sysreg, vfp_gdb_set_sysreg,
530 gdb_find_static_feature("arm-vfp-sysregs.xml"),
534 if (cpu_isar_feature(aa32_mve, cpu) && tcg_enabled()) {
535 gdb_register_coprocessor(cs, mve_gdb_get_reg, mve_gdb_set_reg,
536 gdb_find_static_feature("arm-m-profile-mve.xml"),
539 gdb_register_coprocessor(cs, arm_gdb_get_sysreg, arm_gdb_set_sysreg,
540 arm_gen_dynamic_sysreg_feature(cs, cs->gdb_num_regs),
543 #ifdef CONFIG_TCG
544 if (arm_feature(env, ARM_FEATURE_M) && tcg_enabled()) {
545 gdb_register_coprocessor(cs,
546 arm_gdb_get_m_systemreg, arm_gdb_set_m_systemreg,
547 arm_gen_dynamic_m_systemreg_feature(cs, cs->gdb_num_regs), 0);
548 #ifndef CONFIG_USER_ONLY
549 if (arm_feature(env, ARM_FEATURE_M_SECURITY)) {
550 gdb_register_coprocessor(cs,
551 arm_gdb_get_m_secextreg, arm_gdb_set_m_secextreg,
552 arm_gen_dynamic_m_secextreg_feature(cs, cs->gdb_num_regs), 0);
554 #endif
556 #endif /* CONFIG_TCG */