diff options
| author | Tom Rini <[email protected]> | 2023-01-12 10:15:24 -0500 |
|---|---|---|
| committer | Tom Rini <[email protected]> | 2023-01-12 10:15:24 -0500 |
| commit | f58885d002302b8047446a6a15f7376bb7b1ea32 (patch) | |
| tree | b87608f2330d6190c3dcfad66eba8e9da5c47de2 /doc | |
| parent | ee4f86cc042129abf1b16fcfbf4fc705b03375b6 (diff) | |
| parent | 85fd48984e670d45eddd86710aa47c38baa738ca (diff) | |
Merge branch '2023-01-11-assorted-general-updates'
- Assorted Kconfig cleanups, code clean ups, env+ubi updates, correct
return value propagation out of environment scripts, and update CI to
latest "jammy" tag.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/android/fastboot.rst | 18 | ||||
| -rw-r--r-- | doc/board/intel/edison.rst | 2 | ||||
| -rw-r--r-- | doc/usage/cmd/exit.rst | 4 |
3 files changed, 22 insertions, 2 deletions
diff --git a/doc/android/fastboot.rst b/doc/android/fastboot.rst index 7611f07038e..1ad8a897c85 100644 --- a/doc/android/fastboot.rst +++ b/doc/android/fastboot.rst @@ -28,6 +28,7 @@ The following OEM commands are supported (if enabled): - ``oem partconf`` - this executes ``mmc partconf %x <arg> 0`` to configure eMMC with <arg> = boot_ack boot_partition - ``oem bootbus`` - this executes ``mmc bootbus %x %s`` to configure eMMC +- ``oem run`` - this executes an arbitrary U-Boot command Support for both eMMC and NAND devices is included. @@ -227,6 +228,23 @@ and on the U-Boot side you should see:: Starting kernel ... +Running Shell Commands +^^^^^^^^^^^^^^^^^^^^^^ + +Normally, arbitrary U-Boot command execution is not enabled. This is so +fastboot can be used to update systems using verified boot. However, such +functionality can be useful for production or when verified boot is not in use. +Enable ``CONFIG_FASTBOOT_OEM_RUN`` to use this functionality. This will enable +``oem run`` command, which can be used with the fastboot client. For example, +to print "Hello at 115200 baud" (or whatever ``CONFIG_BAUDRATE`` is), run:: + + $ fastboot oem run:'echo Hello at $baudrate baud' + +You can run any command you would normally run on the U-Boot command line, +including multiple commands (using e.g. ``;`` or ``&&``) and control structures +(``if``, ``while``, etc.). The exit code of ``fastboot`` will reflect the exit +code of the command you ran. + References ---------- diff --git a/doc/board/intel/edison.rst b/doc/board/intel/edison.rst index 5a65673d1e0..782d75a6745 100644 --- a/doc/board/intel/edison.rst +++ b/doc/board/intel/edison.rst @@ -90,7 +90,7 @@ If you want to check if the board is ready, type: .. code-block:: none - lsusb | egrep "8087|8086" + lsusb | grep -E "8087|8086" Bus 001 Device 004: ID 8086:e005 Intel Corp. If you see a device with the same ID as above, the board is waiting for your diff --git a/doc/usage/cmd/exit.rst b/doc/usage/cmd/exit.rst index 769223c4775..3edb12809ce 100644 --- a/doc/usage/cmd/exit.rst +++ b/doc/usage/cmd/exit.rst @@ -37,4 +37,6 @@ executed. Return value ------------ -$? is always set to 0 (true). +$? is default set to 0 (true). In case zero or positive integer parameter +is passed to the command, the return value is the parameter value. In case +negative integer parameter is passed to the command, the return value is 0. |
