ShuriZma
/
xemu
mirror of https://github.com/xemu-project/xemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

plugins: expand kernel-doc for memory query and instrumentation 

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-Id: <20210312172821.31647-13-alex.bennee@linaro.org>
This commit is contained in:
Alex Bennée 2021-03-12 17:28:19 +00:00
parent 8affbacb06
commit fc292a7e7c
1 changed files with 30 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
include/qemu/qemu-plugin.h
View File

@ -393,24 +393,48 @@ uint64_t qemu_plugin_insn_vaddr(const struct qemu_plugin_insn *insn);
*/ */
void *qemu_plugin_insn_haddr(const struct qemu_plugin_insn *insn); void *qemu_plugin_insn_haddr(const struct qemu_plugin_insn *insn);
/* /**
* Memory Instrumentation * typedef qemu_plugin_meminfo_t - opaque memory transaction handle
* *
* The anonymous qemu_plugin_meminfo_t and qemu_plugin_hwaddr types * This can be further queried using the qemu_plugin_mem_* query
* can be used in queries to QEMU to get more information about a * functions.
* given memory access.
*/ */
typedef uint32_t qemu_plugin_meminfo_t; typedef uint32_t qemu_plugin_meminfo_t;
/** struct qemu_plugin_hwaddr - opaque hw address handle */
struct qemu_plugin_hwaddr; struct qemu_plugin_hwaddr;
/* meminfo queries */ /**
* qemu_plugin_mem_size_shift() - get size of access
* @info: opaque memory transaction handle
*
* Returns: size of access in ^2 (0=byte, 1=16bit, 2=32bit etc...)
*/
unsigned int qemu_plugin_mem_size_shift(qemu_plugin_meminfo_t info); unsigned int qemu_plugin_mem_size_shift(qemu_plugin_meminfo_t info);
/**
* qemu_plugin_mem_is_sign_extended() - was the access sign extended
* @info: opaque memory transaction handle
*
* Returns: true if it was, otherwise false
*/
bool qemu_plugin_mem_is_sign_extended(qemu_plugin_meminfo_t info); bool qemu_plugin_mem_is_sign_extended(qemu_plugin_meminfo_t info);
/**
* qemu_plugin_mem_is_big_endian() - was the access big endian
* @info: opaque memory transaction handle
*
* Returns: true if it was, otherwise false
*/
bool qemu_plugin_mem_is_big_endian(qemu_plugin_meminfo_t info); bool qemu_plugin_mem_is_big_endian(qemu_plugin_meminfo_t info);
/**
* qemu_plugin_mem_is_store() - was the access a store
* @info: opaque memory transaction handle
*
* Returns: true if it was, otherwise false
*/
bool qemu_plugin_mem_is_store(qemu_plugin_meminfo_t info); bool qemu_plugin_mem_is_store(qemu_plugin_meminfo_t info);
/** /**
* qemu_plugin_get_hwaddr() - return handle for memory operation * qemu_plugin_get_hwaddr() - return handle for memory operation
* @info: opaque memory info structure
* @vaddr: the virtual address of the memory operation * @vaddr: the virtual address of the memory operation
* *
* For system emulation returns a qemu_plugin_hwaddr handle to query * For system emulation returns a qemu_plugin_hwaddr handle to query