aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlex Bennée <alex.bennee@linaro.org>2023-08-29 17:15:28 +0100
committerAlex Bennée <alex.bennee@linaro.org>2023-08-30 14:57:59 +0100
commit8dd7a4b3487ab93ff8fddc5f818942ff39d4550f (patch)
tree5baa59a096ded1fb2c83f59fb0cb48abe594bb3a
parentd0e5fa849db4d729e0607ef597cb31eac79532a3 (diff)
downloadqemu-8dd7a4b3487ab93ff8fddc5f818942ff39d4550f.zip
qemu-8dd7a4b3487ab93ff8fddc5f818942ff39d4550f.tar.gz
qemu-8dd7a4b3487ab93ff8fddc5f818942ff39d4550f.tar.bz2
gdbstub: move comment for gdb_register_coprocessor
Use proper kdoc style comments for this API function. Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org> Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Message-Id: <20230829161528.2707696-13-alex.bennee@linaro.org>
-rw-r--r--gdbstub/gdbstub.c6
-rw-r--r--include/exec/gdbstub.h10
2 files changed, 10 insertions, 6 deletions
diff --git a/gdbstub/gdbstub.c b/gdbstub/gdbstub.c
index fdebfe2..349d348 100644
--- a/gdbstub/gdbstub.c
+++ b/gdbstub/gdbstub.c
@@ -456,12 +456,6 @@ static int gdb_write_register(CPUState *cpu, uint8_t *mem_buf, int reg)
return 0;
}
-/* Register a supplemental set of CPU registers. If g_pos is nonzero it
- specifies the first register number and these registers are included in
- a standard "g" packet. Direction is relative to gdb, i.e. get_reg is
- gdb reading a CPU register, and set_reg is gdb modifying a CPU register.
- */
-
void gdb_register_coprocessor(CPUState *cpu,
gdb_get_reg_cb get_reg, gdb_set_reg_cb set_reg,
int num_regs, const char *xml, int g_pos)
diff --git a/include/exec/gdbstub.h b/include/exec/gdbstub.h
index 0ee39cf..16a13904 100644
--- a/include/exec/gdbstub.h
+++ b/include/exec/gdbstub.h
@@ -14,6 +14,16 @@
/* Get or set a register. Returns the size of the register. */
typedef int (*gdb_get_reg_cb)(CPUArchState *env, GByteArray *buf, int reg);
typedef int (*gdb_set_reg_cb)(CPUArchState *env, uint8_t *buf, int reg);
+
+/**
+ * gdb_register_coprocessor() - register a supplemental set of registers
+ * @cpu - the CPU associated with registers
+ * @get_reg - get function (gdb reading)
+ * @set_reg - set function (gdb modifying)
+ * @num_regs - number of registers in set
+ * @xml - xml name of set
+ * @gpos - non-zero to append to "general" register set at @gpos
+ */
void gdb_register_coprocessor(CPUState *cpu,
gdb_get_reg_cb get_reg, gdb_set_reg_cb set_reg,
int num_regs, const char *xml, int g_pos);