[PATCH v2 7/7] efi_loader: Add documentation for the EFI log
Simon Glass
sjg at chromium.org
Mon Dec 2 01:12:43 CET 2024
Add a note in the documentation about this feature.
Signed-off-by: Simon Glass <sjg at chromium.org>
---
Changes in v2:
- Rebase on efil series (memory address/pointers)
doc/develop/uefi/uefi.rst | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)
diff --git a/doc/develop/uefi/uefi.rst b/doc/develop/uefi/uefi.rst
index 48d6110b2ad..23d7dfc166d 100644
--- a/doc/develop/uefi/uefi.rst
+++ b/doc/develop/uefi/uefi.rst
@@ -1004,6 +1004,28 @@ This driver is only available if U-Boot is configured with::
CONFIG_BLK=y
CONFIG_PARTITIONS=y
+Logging
+-------
+
+The EFI subsystem supports logging of boot-services calls to a memory area. The
+log can then be shown using the ``efidebug log`` command. Note that only a few
+calls are logged at present.
+
+To enable this feature::
+
+ CONFIG_EFI_LOG=y
+ CONFIG_EFI_LOG_SIZE=0x4000
+ CONFIG_BLOBLIST_SIZE_RELOC=0x5000
+
+The bloblist size must be set to larger than the EFI size. For now the log size
+is fixed at the start.
+
+Logging is performed within the internal U-Boot functions, not at the
+boot-services interface. This makes it possible to log EFI calls made by U-Boot
+itself, such as memory allocations.
+
+See the :doc:`/usage/cmd/efidebug` (*log* subcommand) for more information.
+
Miscellaneous
-------------
--
2.34.1
More information about the U-Boot
mailing list