smallsolar/u-boot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

shim: Add a flag to make the setting persistent

Browse Source 
Provide a -n flag to 'shim debug' so that the setting persists across
reboots.

Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Simon Glass
2025-08-29 07:28:42 -06:00
parent b304fb16d7
commit a5f843f0f2
2 changed files with 27 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
doc/usage/cmd/shim.rst
View File

@@ -8,7 +8,7 @@ Synopsis
::
shim debug [<0/1>]
shim debug [[-n] <0/1>]
Description
-----------
@@ -36,6 +36,7 @@ Controls the Shim verbose debugging mode.
shim debug # Display current debug state (0 or 1)
shim debug 0 # Disable verbose debugging
shim debug 1 # Enable verbose debugging
shim debug -n 1 # Enable verbose debugging (non-volatile)
The command reads from or writes to the ``SHIM_VERBOSE`` EFI variable in the
Shim Lock GUID namespace. When verbose mode is enabled (value = 1), Shim will
@@ -44,6 +45,7 @@ output additional debugging information during the boot process. When disabled
**Parameters:**
* ``-n`` - Makes the variable non-volatile (persistent across reboots)
* ``<0/1>`` - Optional parameter to set debug mode:
* ``0`` - Disable verbose debugging
@@ -69,6 +71,10 @@ Disable verbose debugging::
=> shim debug 0
Enable verbose debugging with persistence across reboots::
=> shim debug -n 1
Configuration
~~~~~~~~~~~~~
@@ -86,12 +92,14 @@ The command uses the EFI variable services to read and write the
* **Variable Name:** ``SHIM_VERBOSE`` (Unicode string)
* **GUID:** EFI Shim Lock GUID (``605dab50-e046-4300-abb6-3dd810dd8b23``)
* **Attributes:** ``EFI_VARIABLE_BOOTSERVICE_ACCESS``
* **Attributes:** ``EFI_VARIABLE_BOOTSERVICE_ACCESS`` (default) or
``EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_NON_VOLATILE`` (with ``-n`` flag)
* **Data Type:** 32-bit unsigned integer (4 bytes)
* **Values:** 0 (disabled) or 1 (enabled)
The variable is stored in the EFI variable store and persists across reboots
until explicitly changed or the variable store is cleared.
By default, the variable is volatile and will be reset on reboot. When the
``-n`` flag is used, the variable becomes non-volatile and persists across
reboots until explicitly changed or the variable store is cleared.
See Also
~~~~~~~~