From patchwork Fri Oct 3 16:54:54 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 482 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=1759510560; bh=/yufxoTpOUTuzWsAZFgQqljNlfDAdl+FRWBDHU9My9k=; 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=ObPOiRqRna/L1AIyoUXC55a5LYWzNaucJk6S4KHglMrAg2ItLyfr+dPCzMeHqWtwh GC/7JqeFMHetgz9hBPKNmJ5efNnOOJ6gnSmvj+ewpLHg0m02H/PcokpFF3MujrDBVG g7J4wVTby3Qq6EWlTVErq9dnvxHnfnmdi73Og3QZARf8h0vaUnNFGSvJWmpLF9Ugd9 49IHmH7v3OTwVgAMN5t293yl/Y/goE9SPPlVO4riLVdpqCtDGN+HY85pSQiRdmZ5Z2 FVvihi/N90+qndssef8sPm/QerTtxzGuyH+15LaXU6/15Rmn0tNFjzlRnzINSjPyIf Yn44d0om50OxQ== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 6781967EBD for ; Fri, 3 Oct 2025 10:56:00 -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 nLHSnna39nYE for ; Fri, 3 Oct 2025 10:56:00 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510558; bh=/yufxoTpOUTuzWsAZFgQqljNlfDAdl+FRWBDHU9My9k=; 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=FGKr4omCV3PPM7/LG8pXf1R9R7TwsCVZfrQx6PzZpLL5UMsYvHKzHtPW9kZ7OWoCO V+vuws9uO+Dp+Z4haxyOG+kCjp4Jya2Y7wKwSohvGwK91lii9hFzImsOQ7quOVOqZw TesOUccrIU5Bq+hkLE/8DOZWA88W9Yd42TM/znt9kZ19TEz+xOvkod0s4mqePl7UCn C6ifmg3eedkggH8eu6HXy+NiepdilglCQbKryHA3ukI9WI5QPlDbVZGty3/9Q0u/Fb wentNHIV4jJQ96CciAv9ofr44cmYvTJP04eeab87UmlveaK6+euY0hqGWogSsHUEHt FJQs2AkE7o2lA== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id B06BC67EC0 for ; Fri, 3 Oct 2025 10:55:58 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510555; bh=1bbsovDHsv0O0k0pbN64d1JHw3KHJKVN2w+ICGnlnME=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=No93JFiTdXZ06JgRK/QfIlUVbDPlf3PiCMpjdcJ2KD6PY69YzXtpgDk6tkNZeK3Q3 S5IVTvOf4xbtDyqfBwM8SgopY0Qvq88Q064zPYCj2p9aPq/s5PH3GMpmkex7OAY1YM lSvJffoGwHtnbCSGkCKqXxxUMOzus3D5txtZev6tXHQ/4UKuepTTZhkd6AUhw6amuT 89JlcHQQGDlotgPa8B8J1iPt4wtBYeshi51tCoQfBO3MR4TmqMNm0ZYWMFS1EA6DSq zNt+Iq0X8HhKXsa+hhTgipXsWyCjkjw4dNUq9OVORQaAwJ4wp27McMTISGfp03zyHM k1/N7rXx5EdRw== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 7D55967E12; Fri, 3 Oct 2025 10:55:55 -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 saweg3GBZ2X3; Fri, 3 Oct 2025 10:55:55 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1759510555; bh=2RVJwugpqrQc8TdZuyYfyln6Z8czigItzeXcyo4gFUY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=YpeReUpX9nNvMho0EySXI2LBhclJN7ZvtdclfYm5DrjlIGZlLJu580P9HWl2mwO17 w+mX/PHcOCSY0Y3UObooHsyPM3CGGc3K5H1A19ugCKx9dQoGLBFvk1pYwhc30AXT9M sH2rjZsHTVno6qZoIwL2DKsI4mj8Z5Kbi6LGShrw20BDNu4JyTiPXma9S8OB9Fiwca WYnpP/QM1N7d7PmcY26pKI3tlABBndlVUXqnlg2i+CPAq5BpetA5YOD5NInpmk1zaz a5SNwXg59j60wLCfIqAJqn4JtzbMBUxzuVSQODh1j/uml7zBCnsjdDRcMfCOmGomRp BDmlWFUaRMfdg== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id A49D067E7C; Fri, 3 Oct 2025 10:55:54 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Fri, 3 Oct 2025 10:54:54 -0600 Message-ID: <20251003165525.440173-2-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251003165525.440173-1-sjg@u-boot.org> References: <20251003165525.440173-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: 4SDTCYAPKBPZV7S6GBVTCHVSR4WWX43A X-Message-ID-Hash: 4SDTCYAPKBPZV7S6GBVTCHVSR4WWX43A 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 , Claude X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 01/22] doc: sandbox: Update command-line options documentation 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 Some recent flags don't have documentation included. Before adding more flags, fix these: -A, --no_term_present: For pager testing -k, --select_unittests: Select specific unit tests -P, --pager_bypass: Enable pager-bypass mode -W, --title: Set window title Also fix the documentation for --double_lcd which uses -K not -k Co-developed-by: Claude Signed-off-by: Simon Glass --- doc/arch/sandbox/sandbox.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/doc/arch/sandbox/sandbox.rst b/doc/arch/sandbox/sandbox.rst index 89255cb14dd..31a670ce2ab 100644 --- a/doc/arch/sandbox/sandbox.rst +++ b/doc/arch/sandbox/sandbox.rst @@ -103,6 +103,9 @@ available options. Some of these are described below: even if CONFIG_AUTOBOOT_KEYED is enabled, since it interfers with tests and normal usage +-A, --no_term_present + Assume no terminal is present. This is used for pager testing. + -b. boot The distro boot feature doesn't run by default on sandbox, since it normally not vert useful. For the distro_bootcmds to succeed, quite a bit of setup is @@ -162,7 +165,10 @@ available options. Some of these are described below: writes an elf file containing the extracted portion, then execs it. This argument provides the filename, so it can be removed before U-Boot exits. --k, --double_lcd +-k, --select_unittests + Select specific unit tests to run. This is only used with SPL. + +-K, --double_lcd Doubles the size of the emulated LCD, so that it appears bigger. This can be useful on large or high-resolution displays. @@ -199,6 +205,9 @@ available options. Some of these are described below: each program is extracted from the original image and executed (see -j), this is the only way that subsequent phases can locate the full image. +-P, --pager_bypass + Enable pager bypass mode for testing. + -r, --read Read driver state from a dtb file. In conjunction with `-w`, this allows sandbox to save and restore emulated hardware state (such as a TPM) across @@ -248,6 +257,9 @@ available options. Some of these are described below: sandbox to save and restore emulated hardware state (such as a TPM) across each U-Boot phase. +-W, --title + Set the window title for the sandbox display. + Environment Variables ---------------------