summaryrefslogtreecommitdiff
path: root/doc/usage
diff options
context:
space:
mode:
authorSimon Glass <[email protected]>2024-10-28 13:47:57 +0100
committerTom Rini <[email protected]>2024-11-03 21:27:12 -0600
commit5400c4bc0528b1f2bebd97de1deed62cbd65039b (patch)
tree41c5bd417f61cfa78a0667e2b10491901cc9a92d /doc/usage
parentec6d30649cd5026acf64301cca3d1721c16e69e7 (diff)
sandbox: Add a way to show the sandbox memory-mapping
This is mostly hidden in the background, but it is sometimes useful to look at it. Add a function to allow this. Signed-off-by: Simon Glass <[email protected]>
Diffstat (limited to 'doc/usage')
-rw-r--r--doc/usage/cmd/sb.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/usage/cmd/sb.rst b/doc/usage/cmd/sb.rst
index 6f54f9d9eb7..37431aff7c8 100644
--- a/doc/usage/cmd/sb.rst
+++ b/doc/usage/cmd/sb.rst
@@ -12,6 +12,7 @@ Synopsis
::
sb handoff
+ sb map
sb state
Description
@@ -26,6 +27,24 @@ sb handoff
This shows information about any handoff information received from SPL. If
U-Boot is started from an SPL build, it shows a valid magic number.
+sb map
+~~~~~~
+
+This shows any mappings between sandbox's emulated RAM and the underlying host
+address-space.
+
+Fields shown are:
+
+Addr
+ Address in emulated RAM
+
+Mapping
+ Equivalent address in the host address-space. While sandbox requests address
+ ``0x10000000`` from the OS, this is not always available.
+
+Refcnt
+ Shows the number of references to this mapping.
+
sb state
~~~~~~~~
@@ -42,6 +61,12 @@ as ``sandbox_spl``::
=> sb handoff
SPL handoff magic 14f93c7b
+This shows output from the *sb map* subcommand, with a single mapping::
+
+ Sandbox memory-mapping
+ Addr Mapping Refcnt
+ ff000000 000056185b46d6d0 2
+
This shows output from the *sb state* subcommand::
=> sb state