| Simon Glass | 917ae97 | 2024-10-28 13:47:56 +0100 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | |
| 3 | .. index:: |
| 4 | single: sbi (command) |
| 5 | |
| 6 | sbi command |
| 7 | =========== |
| 8 | |
| 9 | Synopsis |
| 10 | -------- |
| 11 | |
| 12 | :: |
| 13 | |
| 14 | sb handoff |
| Simon Glass | 9a27d9d | 2024-10-28 13:47:57 +0100 | [diff] [blame] | 15 | sb map |
| Simon Glass | 917ae97 | 2024-10-28 13:47:56 +0100 | [diff] [blame] | 16 | sb state |
| 17 | |
| 18 | Description |
| 19 | ----------- |
| 20 | |
| 21 | The *sb* command is used to display information about sandbox's internal |
| 22 | operation. See :doc:`/arch/sandbox/index` for more information. |
| 23 | |
| 24 | sb handoff |
| 25 | ~~~~~~~~~~ |
| 26 | |
| 27 | This shows information about any handoff information received from SPL. If |
| 28 | U-Boot is started from an SPL build, it shows a valid magic number. |
| 29 | |
| Simon Glass | 9a27d9d | 2024-10-28 13:47:57 +0100 | [diff] [blame] | 30 | sb map |
| 31 | ~~~~~~ |
| 32 | |
| 33 | This shows any mappings between sandbox's emulated RAM and the underlying host |
| 34 | address-space. |
| 35 | |
| 36 | Fields shown are: |
| 37 | |
| 38 | Addr |
| 39 | Address in emulated RAM |
| 40 | |
| 41 | Mapping |
| 42 | Equivalent address in the host address-space. While sandbox requests address |
| 43 | ``0x10000000`` from the OS, this is not always available. |
| 44 | |
| 45 | Refcnt |
| 46 | Shows the number of references to this mapping. |
| 47 | |
| Simon Glass | 917ae97 | 2024-10-28 13:47:56 +0100 | [diff] [blame] | 48 | sb state |
| 49 | ~~~~~~~~ |
| 50 | |
| 51 | This shows basic information about the sandbox state, currently just the |
| 52 | command-line with which sandbox was started. |
| 53 | |
| 54 | Example |
| 55 | ------- |
| 56 | |
| 57 | This shows checking for the presence of SPL-handoff information. For this to |
| 58 | work, ``u-boot-spl`` must be run, with build that enables ``CONFIG_SPL``, such |
| 59 | as ``sandbox_spl``:: |
| 60 | |
| 61 | => sb handoff |
| 62 | SPL handoff magic 14f93c7b |
| 63 | |
| Simon Glass | 9a27d9d | 2024-10-28 13:47:57 +0100 | [diff] [blame] | 64 | This shows output from the *sb map* subcommand, with a single mapping:: |
| 65 | |
| 66 | Sandbox memory-mapping |
| 67 | Addr Mapping Refcnt |
| 68 | ff000000 000056185b46d6d0 2 |
| 69 | |
| Simon Glass | 917ae97 | 2024-10-28 13:47:56 +0100 | [diff] [blame] | 70 | This shows output from the *sb state* subcommand:: |
| 71 | |
| 72 | => sb state |
| 73 | Arguments: |
| 74 | /tmp/b/sandbox/u-boot -D |
| 75 | |
| 76 | Configuration |
| 77 | ------------- |
| 78 | |
| 79 | The *sb handoff* command is only supported if CONFIG_HANDOFF is enabled. |