From patchwork Wed Aug 20 00:40:32 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 56 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755650505; bh=+5PW6caNWLrhD2IhqeHaJ/VncUPM7yUbAX+eTtPldh8=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=wZu9z1A/wCrt7HAC2N7yme/KYlBkLw48LVeU8n1eUePSo99Sx/RQzXuc8ZpBMvZvZ utx5WYapHCQWw0s3xq1EYlPNTmzttV4NRoosx/SNY+z6Fsn7RMvV/1zH8k1Ne97+nO wik6sunX+FIkIxSwhQzMqrhDC0yT26oYF7bpDJt0V8Lzmh4aj8z/XY6aCvdE2J9ypr mzQ0dBTPo6WVX66ZKLDrPzjlHw1R920IKl3s84Caf98JEDcp3p3PiuB99RzNarDBOA 5tQ9FS0h65Ovl8matG1JUOKUe2+XtDbzZNb/7PvLF2pOe5Bx9FHqsLuRpqKHo34kEv Ah+sALb++IKIg== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 0C25A67659 for ; Tue, 19 Aug 2025 18:41:45 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id gvg6y1IdiiAO for ; Tue, 19 Aug 2025 18:41:44 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755650504; bh=+5PW6caNWLrhD2IhqeHaJ/VncUPM7yUbAX+eTtPldh8=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=ROhk1R/fSnMhy3CtQk9CfQMGRIS/KzJRhgmKPkMNIQtuNeCNHH2UjFGRxVek0yWpA bvssmK18baBZYfj3oz1VMBk01QOejBE/tLt+uX63BoqykGWeVVL8Nn/xi1bKS4SfSD hN0NW1znXTK41Zv6b+RWQNaNM+drxlGCgtXF7cH03PFx4N/6eQrPAUGmvxaHD2+dgb Gd0hkUIcVL79t84WpJlugpEXBZfMd/1l7EmoTzCEDMIMq5+AqXJEP7Uaw9JpBiGimB f1lzxpSQfsQt2N8+U2v0NNJo0mj8g9tW0C9FMPGzSuP5cbcJO7aMTfgPa2c+ttQVWQ 6l81gufmrf8Tg== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id EE313675DE for ; Tue, 19 Aug 2025 18:41:44 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755650502; bh=oymPt7wWZapbNt4fiZ/BLT0HwX5eP6dodRJlaCKhEIA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Vtnr3SLX2SaiodsXNmU/jMl5VzVzILFzZDg3KuLcexfqLQdPrqkHGNyxZLOkQkjwb djBQmDvSs4GjeW3TRiDyUDr2bqxnbcZvES53eYydFSHVfsrVDx/vke5XFlWgS5YmNU JtxfefhVw4rRm3VTW1Xs7S9JHo3KSGQWBjDs0FB305WMHkkN7718g/sJvwYZO4V4Zt Se2b87Zcqy+hJ8PURvPSZNMbi1BRqfqMSFnWGfjQGK4bWuaoRxpQ91ncqLfkKZUtsi GgVCsSR6kZUqMhOqe/436Bgfj7UDMbMXvjGwy+xYvyT5F/W0TXZKdFXuGUCOnMPlV3 Nb79yM1EfqbCA== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id A64446765D; Tue, 19 Aug 2025 18:41:42 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id 9HznwirYPWyl; Tue, 19 Aug 2025 18:41:42 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755650501; bh=Qg3pgFkbhcg0hwAo2wuw7p3Q9MymPfc95S2uVRJmCJs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=RBpvg2hWhZc4zF8L9Sv+/6M+p1mnBE2oqlbJQ6ZQiPOU/QghTXBGN3IQ0n+yF3gwc hYSz9F+EEcmGwiu0Qs+OBG7N0d+2m7iGwGFx17u7A9aqGk2LrMG8U9KAq+FE/FvbSV yYTsB+nRYNL3vI4z/ef1+49qA1I1JD0SYf9usyIiOpQemqPPspW6bnWHuREgIBvGHn kTyPnBig53GncqrJbSjh3QcRdwxQhsvCX6+COuMyGduI/vFZUXtGv1atexEUE3ph8U Fmm+0aFCvlz8JeIQwx2CnG8LlG9yWQEjGwGOPTkEqkdMaHL7Q4N01n7gL+YWVVjwPE lbl7h2Kmr4Y8A== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id ED85A675B8; Tue, 19 Aug 2025 18:41:40 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Tue, 19 Aug 2025 18:40:32 -0600 Message-ID: <20250820004039.3920254-19-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250820004039.3920254-1-sjg@u-boot.org> References: <20250820004039.3920254-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: 44GIITWQ2ARBKNUQM65XU7WMHIAXECSW X-Message-ID-Hash: 44GIITWQ2ARBKNUQM65XU7WMHIAXECSW X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Heinrich Schuchardt , Simon Glass X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 18/18] efi: doc: Add documentation for efidebug command in the app List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass Mention the efidebug command specifically the EFI-app documentaion, to highlight its usefulness. Signed-off-by: Simon Glass --- doc/develop/uefi/u-boot_on_efi.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/develop/uefi/u-boot_on_efi.rst b/doc/develop/uefi/u-boot_on_efi.rst index d20d5b00ec6..387ace48f5b 100644 --- a/doc/develop/uefi/u-boot_on_efi.rst +++ b/doc/develop/uefi/u-boot_on_efi.rst @@ -143,6 +143,27 @@ enough) should be straightforward. Use the 'reset' command to get back to EFI. +EFI Debugging Commands +~~~~~~~~~~~~~~~~~~~~~~ +When running as an EFI application, U-Boot provides access to the 'efidebug' +command, which offers a subset of functionality useful for debugging and +inspecting the UEFI environment. This command allows you to: + +* Display memory maps with 'efidebug memmap' +* Show EFI system tables with 'efidebug show tables' +* Manage boot options with 'efidebug boot' subcommands: + + - dump - Display current boot options + - add - Add new boot options + - rm - Remove boot options + - order - Display boot order + +This command uses the EFI system table and runtime services to provide this +functionality, so it can help with understanding and debugging UEFI +environments. + +See the :doc:`/usage/cmd/efidebug` for more information. + EFI Payload ~~~~~~~~~~~ The payload approach is a different kettle of fish. It works by building