From patchwork Fri Aug 22 14:21:47 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 121 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=1755872564; bh=hPObIfvqSuvYk6Rs/VPAILe2iRiHKmi/JmRjYk070k8=; 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=BdoAhtVkRnxt5jWcEsxQHTOAnaUrdjCCjtffRw3og1CPNkYjmo2Z0OGWdU7QPsFEF htlU/Og7i42WNk/U+Bsl54CsPR+ADwGalPtmivWXN4m4R8Fah03hfhWIgu3I08kEYK g3dVpJoJkr4XUeRC5MJdhSrZwtk53QW3j+wbjBAlUGBllkEYEGfLLohhf6QDHu/5Z3 v7iVj7G1TChx0jwWFBMY1SBq5QScm6NETLEg3uw2DncHWE2gI61C6kn7LIkbugJFMg B6vD4N5/ycHBsuaAM0m2Zulbyem2Rbf0m9u+ph7W1R872PMjrbUTG84L5W+Xe/gUUb +jTmQUPzkQ1AQ== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 015AF676F0 for ; Fri, 22 Aug 2025 08:22:44 -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 rfiYgPj2ayjU for ; Fri, 22 Aug 2025 08:22:43 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755872563; bh=hPObIfvqSuvYk6Rs/VPAILe2iRiHKmi/JmRjYk070k8=; 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=rpWr9KCekfz/Km6+o0JxPpNyg37g//QJXhT52H0t0HJF8OlJwMtLEeF0jt037QDUP ceoNA/wH1SghvwNeE5FmGMKZfG8H3CQ1umY1RGmQfHnQyYElk4qFbUDNEnMl2h0ShW mjBtCXbFyDeS28+guk1Gt7N/TwKTZ1D3jcK5mBUUD60koAHFPbd9WSe6bkl81c1tse 81Q4Id4I8uJ2W4xRHDxlkIQ2todDn5Uzbhfb2aHBSF9koO46D7tcGxk5F12NMoGcT+ M572LmGqNppjSPLVsEPeS+o4e37ZWfaiwQQN5yR2lEUrfz03IBPK+iYfjN4Xo+JZ7p CA3hlUTjT6+Jg== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 1A43267721 for ; Fri, 22 Aug 2025 08:22:43 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755872559; bh=7VVHHKIrxSVcqac/N7079jkRZ9f0lpTwUj98Zr0hb70=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=l2UE9C40pxuAK8zOoPy0Ia3LeMHrLQitiuB3zN3CbGViOuKgmkXy96Zw2LzS0977n EyhqXO6IDPXInZkWrl93XNgGDmzIVHNmHjRis3ueNEPyoRnjEFKyizs7DovZx1oGzb 8DKbEh6uE/WMZkLOZSk9P21b94sLnJBrabsPmzyq2pDpAEi/PWUDHXsIHmQX3XlclK DYJE9ptpu/uiH6Eukidr2B86XBNunx1IxwywzgH8lOjNGL/kD9NC2ZFNo9IkgIgXMM ErGKNKXwiIuyrWMEWjDxtx1/guDhFHU5ilaw57momApJbgkFJGRQT98PmhDk5NFb+K X7QxqFoOF5KPg== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 48DFF6771B; Fri, 22 Aug 2025 08:22:39 -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 fgWu2MsxP3HK; Fri, 22 Aug 2025 08:22:39 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1755872553; bh=qoGX9fSAjPDYz3FzDDh6oIkLcJY92gb3OgkSfDLV/OY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=DFj58dNhdoq7eLThazATT05AV6fYYgt6MyqtWIy5nwMrBtAXbXOKiEmzCi8zruQcL SGuq3xyER9idyYlwvhpNvPh/tLPWolrUto9LqAkWPfQtNwCU+Oa7zK3fSKZIMGbC4x OTJT4u+uQ7ki+cb3WWSK3QmdaP5Jx4My67d5HGeS6VOMHAqlKjfZfniDgjfN93T0uN 1KelFVDX8yr/njKkl/xXda6Kjttm6FyuyNCqO36QMWa0F3uJD74hsPM6WvMGBv+v3n aNNRFGmefNZ6BAe4J+Pu24ybYYqG+gaFniPcVcEsyYBnUqw+fq4O9NX/hTeBXHriuO 2CmhVfbXmoPQw== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id 35DE96771F; Fri, 22 Aug 2025 08:22:33 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Fri, 22 Aug 2025 08:21:47 -0600 Message-ID: <20250822142153.3404275-17-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250822142153.3404275-1-sjg@u-boot.org> References: <20250822142153.3404275-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: PUL74667B4YZBI5ZVZ63FI5DO6BR4KEX X-Message-ID-Hash: PUL74667B4YZBI5ZVZ63FI5DO6BR4KEX 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: Simon Glass X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 16/16] pager: doc: Add mention of the pager feature 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 Add a note about the pager to the console documentation. Signed-off-by: Simon Glass --- doc/usage/console.rst | 16 ++++++++++++++++ doc/usage/environment.rst | 5 +++++ 2 files changed, 21 insertions(+) diff --git a/doc/usage/console.rst b/doc/usage/console.rst index d7d41bca187..95424c43ee9 100644 --- a/doc/usage/console.rst +++ b/doc/usage/console.rst @@ -60,3 +60,19 @@ file ('stdin', 'stdout' or 'stderr') Remember that FILE-related functions CANNOT be used before U-Boot relocation, which is done in `board_init_r()`. + +Pager +----- + +U-Boot has a simple pager feature, enabled with `CONFIG_CONSOLE_PAGER`. It is +only available if both `CONFIG_CONSOLE_MUX` is enabled. + +When activated, the pager pauses at the end of each 'page' (screenful) of +output, shows a prompt and lets the user read the output. To continue, press +SPACE. + +The number of lines before the pager kicks in is configurable using the `pager` +environment variable, which should contain a decimal value. Set it to 0 (or +leave it unset) to disable the pager. If the variable is not present then the +number of lines in the video console is used. If there is no video console, then +`CONSOLE_PAGER_LINES` sets the number of lines. diff --git a/doc/usage/environment.rst b/doc/usage/environment.rst index 6235d7276f0..696acbfd6a5 100644 --- a/doc/usage/environment.rst +++ b/doc/usage/environment.rst @@ -336,7 +336,12 @@ netretry themselves. pager +<<<<<<< HEAD Decimal number of visible lines on the display, or serial console. +======= + Decimal number of visible lines on the display, or serial console. See + :doc:`/usage/console`. +>>>>>>> 949c148e39e (pager: doc: Add mention of the pager feature) rng_seed_size Size of random value added to device-tree node /chosen/rng-seed.