From: Richard Henderson Date: Fri, 8 May 2020 15:43:41 +0000 (-0700) Subject: exec: Add block comments for watchpoint routines X-Git-Tag: v5.1.0-rc0~132^2~26 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=390734a42d003848efc6b73f6b7d8cd8aff8bdab;p=thirdparty%2Fqemu.git exec: Add block comments for watchpoint routines Reviewed-by: Peter Maydell Signed-off-by: Richard Henderson Message-id: 20200508154359.7494-2-richard.henderson@linaro.org Signed-off-by: Peter Maydell --- diff --git a/include/hw/core/cpu.h b/include/hw/core/cpu.h index 5bf94d28cff..07f76981550 100644 --- a/include/hw/core/cpu.h +++ b/include/hw/core/cpu.h @@ -1100,8 +1100,31 @@ int cpu_watchpoint_remove(CPUState *cpu, vaddr addr, vaddr len, int flags); void cpu_watchpoint_remove_by_ref(CPUState *cpu, CPUWatchpoint *watchpoint); void cpu_watchpoint_remove_all(CPUState *cpu, int mask); + +/** + * cpu_check_watchpoint: + * @cpu: cpu context + * @addr: guest virtual address + * @len: access length + * @attrs: memory access attributes + * @flags: watchpoint access type + * @ra: unwind return address + * + * Check for a watchpoint hit in [addr, addr+len) of the type + * specified by @flags. Exit via exception with a hit. + */ void cpu_check_watchpoint(CPUState *cpu, vaddr addr, vaddr len, MemTxAttrs attrs, int flags, uintptr_t ra); + +/** + * cpu_watchpoint_address_matches: + * @cpu: cpu context + * @addr: guest virtual address + * @len: access length + * + * Return the watchpoint flags that apply to [addr, addr+len). + * If no watchpoint is registered for the range, the result is 0. + */ int cpu_watchpoint_address_matches(CPUState *cpu, vaddr addr, vaddr len); #endif