haraldwolff/qemu-patch-raspberry4
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

docs/devel: add some clarifying text for aliases

Browse source 
We do mention the limitation of single parenthood for
memory_region_add_subregion but lets also make it clear how aliases
help solve that conundrum.

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Message-Id: <20220110175104.2908956-7-alex.bennee@linaro.org>
Signed-off-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
This commit is contained in:
Alex Bennée 2022-01-10 17:51:04 +00:00 committed by Philippe Mathieu-Daudé
parent f02b664aad
commit 9d696cd504
1 changed files with 9 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
docs/devel/memory.rst
View file

@ -67,11 +67,15 @@ MemoryRegion):
You initialize a pure container with memory_region_init(). You initialize a pure container with memory_region_init().
- alias: a subsection of another region. Aliases allow a region to be - alias: a subsection of another region. Aliases allow a region to be
split apart into discontiguous regions. Examples of uses are memory banks split apart into discontiguous regions. Examples of uses are memory
used when the guest address space is smaller than the amount of RAM banks used when the guest address space is smaller than the amount
addressed, or a memory controller that splits main memory to expose a "PCI of RAM addressed, or a memory controller that splits main memory to
hole". Aliases may point to any type of region, including other aliases, expose a "PCI hole". You can also create aliases to avoid trying to
add the original region to multiple parents via
`memory_region_add_subregion`.
Aliases may point to any type of region, including other aliases,
but an alias may not point back to itself, directly or indirectly. but an alias may not point back to itself, directly or indirectly.
You initialize these with memory_region_init_alias(). You initialize these with memory_region_init_alias().