mirrors/qemu
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

hw/core: expand on the alignment of CPUState

Browse Source 
Make the relationship between CPUState, ArchCPU and cpu_env a bit
clearer in the kdoc comments.

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Reviewed-by: Pierrick Bouvier <pierrick.bouvier@linaro.org>
Message-ID: <20240530194250.1801701-2-alex.bennee@linaro.org>
Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
This commit is contained in:
Alex Bennée 2024-05-30 20:42:46 +01:00 committed by Philippe Mathieu-Daudé
parent a128c309c9
commit b8a208ccf5
1 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
include/hw/core/cpu.h
View File

@ -391,7 +391,8 @@ struct qemu_work_item;
#define CPU_UNSET_NUMA_NODE_ID -1
/**
* CPUState:
* struct CPUState - common state of one CPU core or thread.
*
* @cpu_index: CPU index (informative).
* @cluster_index: Identifies which cluster this CPU is in.
* For boards which don't define clusters or for "loose" CPUs not assigned
@ -439,10 +440,15 @@ struct qemu_work_item;
* @kvm_fetch_index: Keeps the index that we last fetched from the per-vCPU
* dirty ring structure.
*
* State of one CPU core or thread.
* @neg_align: The CPUState is the common part of a concrete ArchCPU
* which is allocated when an individual CPU instance is created. As
* such care is taken is ensure there is no gap between between
* CPUState and CPUArchState within ArchCPU.
*
* Align, in order to match possible alignment required by CPUArchState,
* and eliminate a hole between CPUState and CPUArchState within ArchCPU.
* @neg: The architectural register state ("cpu_env") immediately follows
* CPUState in ArchCPU and is passed to TCG code. The @neg structure holds
* some common TCG CPU variables which are accessed with a negative offset
* from cpu_env.
*/
struct CPUState {
/*< private >*/