architecture: core: detail reserved/dynamic shared memory

Detail a bit contiguous/reserved and dynamic shared memory are and highlight the latter is preferred on supported platforms. Reviewed-by: Joakim Bech <[email protected]> Signed-off-by: Etienne Carriere <[email protected]>
OP-TEE · Dec 13, 2023 · 1c20201 · 1c20201
1 parent dc8cede
commit 1c20201
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/architecture/core.rst b/architecture/core.rst
@@ -1417,6 +1417,12 @@ shared memory areas known from the OP-TEE core. OP-TEE supports two kinds
 of shared memory areas: an area for contiguous buffers and an area for
 noncontiguous buffers. At least one has to be enabled.
 
+Contiguous shared memory is the historical OP-TEE legacy shared memory
+scheme where a specific physical memory area is shared. Nowadays,
+platforms tend to describe the physical memory layout and enable
+noncontiguous dynamic shared memory, allowing the non-secure OS to
+use its native system memory as legitimate shared memory references.
+
 Contiguous shared buffers
 =========================
 Configuration directives ``CFG_SHMEM_START`` and ``CFG_SHMEM_SIZE``