Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2224030/?format=api
{ "id": 2224030, "url": "http://patchwork.ozlabs.org/api/patches/2224030/?format=api", "web_url": "http://patchwork.ozlabs.org/project/uboot/patch/20260416-ui-cosmetics-v4-3-b843ba661b3f@postmarketos.org/", "project": { "id": 18, "url": "http://patchwork.ozlabs.org/api/projects/18/?format=api", "name": "U-Boot", "link_name": "uboot", "list_id": "u-boot.lists.denx.de", "list_email": "u-boot@lists.denx.de", "web_url": null, "scm_url": null, "webscm_url": null, "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20260416-ui-cosmetics-v4-3-b843ba661b3f@postmarketos.org>", "list_archive_url": null, "date": "2026-04-16T14:57:43", "name": "[v4,3/4] doc: usage: convert autoboot README to rST", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "69aed82bdbc2a99b5a3cdf3b26091d9999656cbd", "submitter": { "id": 90020, "url": "http://patchwork.ozlabs.org/api/people/90020/?format=api", "name": "Ferass El Hafidi", "email": "funderscore@postmarketos.org" }, "delegate": { "id": 3651, "url": "http://patchwork.ozlabs.org/api/users/3651/?format=api", "username": "trini", "first_name": "Tom", "last_name": "Rini", "email": "trini@ti.com" }, "mbox": "http://patchwork.ozlabs.org/project/uboot/patch/20260416-ui-cosmetics-v4-3-b843ba661b3f@postmarketos.org/mbox/", "series": [ { "id": 500175, "url": "http://patchwork.ozlabs.org/api/series/500175/?format=api", "web_url": "http://patchwork.ozlabs.org/project/uboot/list/?series=500175", "date": "2026-04-16T14:57:40", "name": "Autoboot prompt customization and bootmenu cosmetics", "version": 4, "mbox": "http://patchwork.ozlabs.org/series/500175/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2224030/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2224030/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<u-boot-bounces@lists.denx.de>", "X-Original-To": "incoming@patchwork.ozlabs.org", "Delivered-To": "patchwork-incoming@legolas.ozlabs.org", "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=postmarketos.org header.i=@postmarketos.org\n header.a=rsa-sha256 header.s=key1 header.b=aHDw2hsH;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de;\n envelope-from=u-boot-bounces@lists.denx.de; receiver=patchwork.ozlabs.org)", "phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=postmarketos.org", "phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de", "phobos.denx.de;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=postmarketos.org header.i=@postmarketos.org\n header.b=\"aHDw2hsH\";\n\tdkim-atps=neutral", "phobos.denx.de; dmarc=pass (p=quarantine dis=none)\n header.from=postmarketos.org", "phobos.denx.de;\n spf=pass smtp.mailfrom=funderscore@postmarketos.org" ], "Received": [ "from phobos.denx.de (phobos.denx.de\n [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fxLkB3XN2z1yHP\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 17 Apr 2026 00:58:42 +1000 (AEST)", "from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id B5E14841F2;\n\tThu, 16 Apr 2026 16:58:09 +0200 (CEST)", "by phobos.denx.de (Postfix, from userid 109)\n id 38B508420C; Thu, 16 Apr 2026 16:58:07 +0200 (CEST)", "from out-177.mta0.migadu.com (out-177.mta0.migadu.com\n [91.218.175.177])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))\n (No client certificate requested)\n by phobos.denx.de (Postfix) with ESMTPS id 8C305840AB\n for <u-boot@lists.denx.de>; Thu, 16 Apr 2026 16:58:02 +0200 (CEST)" ], "X-Spam-Checker-Version": "SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de", "X-Spam-Level": "", "X-Spam-Status": "No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,\n DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED,\n RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED,\n SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2", "X-Report-Abuse": "Please report any abuse attempt to abuse@migadu.com and\n include these headers.", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=postmarketos.org;\n s=key1; t=1776351481;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=VOtCjwnb5nL4pxpt8ORKORTsYzgI3ZH03AVBnwZ7BXI=;\n b=aHDw2hsHLSHnMeo4hDkC5URVeCo8MiDvrKZBkAMyHoT69wgxwsO1L/k6P3gDVdKhLyCo4r\n mirrBmp/Wf9WUbb3GFsQ6eI/jOF4QWTpU00QlpA+TvnIsdgnhtS8Ic28AtwbL41a9P0+P3\n hsO8NyZ2XT8GLr+iMRMdc5jz98AKE4gc2mtgu4QGvOLjoZaBxquLdkXwXcbqbVUxwED+Xl\n 1lDDNUUBusHeivrnZuCE7krkeUAfxDUQD6+jSPMrQV5713g3kZjfYfbb0bdjLDCFIYlgnO\n FIO+KlfZ+jk8WY/DIfM7mlGx26/RIpVhvh6IT5szOKkDtwcHYbJJi1nD7fURwg==", "From": "Ferass El Hafidi <funderscore@postmarketos.org>", "Date": "Thu, 16 Apr 2026 14:57:43 +0000", "Subject": "[PATCH v4 3/4] doc: usage: convert autoboot README to rST", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"utf-8\"", "Content-Transfer-Encoding": "7bit", "Message-Id": "<20260416-ui-cosmetics-v4-3-b843ba661b3f@postmarketos.org>", "References": "<20260416-ui-cosmetics-v4-0-b843ba661b3f@postmarketos.org>", "In-Reply-To": "<20260416-ui-cosmetics-v4-0-b843ba661b3f@postmarketos.org>", "To": "u-boot@lists.denx.de", "Cc": "Tom Rini <trini@konsulko.com>, Quentin Schulz <quentin.schulz@cherry.de>,\n \"Kory Maincent (TI.com)\" <kory.maincent@bootlin.com>,\n Simon Glass <sjg@chromium.org>,\n Mattijs Korpershoek <mkorpershoek@kernel.org>,\n Anshul Dalal <anshuld@ti.com>, Heinrich Schuchardt <xypron.glpk@gmx.de>,\n Martin Schwan <m.schwan@phytec.de>, David Zang <davidzangcs@gmail.com>,\n Sam Protsenko <semen.protsenko@linaro.org>,\n Christian Marangi <ansuelsmth@gmail.com>,\n Ferass El Hafidi <funderscore@postmarketos.org>", "X-Developer-Signature": "v=1; a=openpgp-sha256; l=13781;\n i=funderscore@postmarketos.org; h=from:subject:message-id;\n bh=Nld+PT02Wk6627mufXp47AmnR6LT4Hs7/oSuQXUD1xM=;\n b=owEBbQKS/ZANAwAKAYSvy9DXiZoDAcsmYgBp4Pj0Srgx+MT6cSdHCtMO2xqBMMHlitJkZYj/p\n HRI20/YzHKJAjMEAAEKAB0WIQQDAbw3+1VcrP15i+6Er8vQ14maAwUCaeD49AAKCRCEr8vQ14ma\n A3dvEACW9eH8Uwa0PReO0GIcLRuOpBWeVnkQmPX3Vhefz9q3IgH6Vw6yj0RJWWiE4VxbUjGbma+\n /523nFNiBQSMTsCb1BWB6XIHQoui+erOKqxjXzPor37WplwRtwc7KN5HG8xUpw7hehXk04A+WHf\n NtqlKKMHXc/H/BOaC1nbbTkOzKpltLzg246PF+Lb7msiBHnbgreZK5a5mQUieZk97cyh2lVSzl8\n I9bC8eTRJXmsZEzo4qXTY1nP1SNB0D/ZYmgoCnXDFmpxCmXHr765Kcc2CYJlsVsGxn5msRSAH83\n Hd7VbZV4DbdpA+R03oVVm462ioRrj1LO+puC0LpnOaNCVCG8wj0xKO0N8F3ujhiTcr3mdUu7r7/\n HF9hAowYvC7OGU0aPPbD+9xXnGccryxDZlVYKviwCM/9JEfvxJbCBR/eMi9IWbefbW2YGBwMfHb\n Tx1gDDneZGaNZEdHtIKcIiwy+rvZuvw+W5QWANFTnNEAKo+97ZPn/Lbrki1mMdNAJHXlGYBEt4P\n IxG7+0ad9Bdz4W5G/+a+IL9ReOwdoOGV0yGQ8xIAqq+GWC4uumcQayAHblcOfc4plgIVBx9tVGC\n sUAHkN7UaRExYgSbldzmPgcZOWxQPDDAM0VeLKZLBkYDbKdSPLZbSd8NnmKwarypNNCXhprPwT2\n dO+A1U519e9qRvQ==", "X-Developer-Key": "i=funderscore@postmarketos.org; a=openpgp;\n fpr=0301BC37FB555CACFD798BEE84AFCBD0D7899A03", "X-Migadu-Flow": "FLOW_OUT", "X-BeenThere": "u-boot@lists.denx.de", "X-Mailman-Version": "2.1.39", "Precedence": "list", "List-Id": "U-Boot discussion <u-boot.lists.denx.de>", "List-Unsubscribe": "<https://lists.denx.de/options/u-boot>,\n <mailto:u-boot-request@lists.denx.de?subject=unsubscribe>", "List-Archive": "<https://lists.denx.de/pipermail/u-boot/>", "List-Post": "<mailto:u-boot@lists.denx.de>", "List-Help": "<mailto:u-boot-request@lists.denx.de?subject=help>", "List-Subscribe": "<https://lists.denx.de/listinfo/u-boot>,\n <mailto:u-boot-request@lists.denx.de?subject=subscribe>", "Errors-To": "u-boot-bounces@lists.denx.de", "Sender": "\"U-Boot\" <u-boot-bounces@lists.denx.de>", "X-Virus-Scanned": "clamav-milter 0.103.8 at phobos.denx.de", "X-Virus-Status": "Clean" }, "content": "Convert the plain text autoboot documentation into rST, so it is visible\nin the public docs. Also decouple CONFIG_AUTOBOOT_PROMPT from\nCONFIG_AUTOBOOT_KEYED in the documentation to reflect previous commits.\n\nSigned-off-by: Ferass El Hafidi <funderscore@postmarketos.org>\n---\n doc/README.autoboot | 162 -------------------------------------------------\n doc/usage/autoboot.rst | 149 +++++++++++++++++++++++++++++++++++++++++++++\n doc/usage/index.rst | 1 +\n 3 files changed, 150 insertions(+), 162 deletions(-)", "diff": "diff --git a/doc/README.autoboot b/doc/README.autoboot\ndeleted file mode 100644\nindex 5e9a5e1cf7f..00000000000\n--- a/doc/README.autoboot\n+++ /dev/null\n@@ -1,162 +0,0 @@\n-SPDX-License-Identifier: GPL-2.0+\n-/*\n- * (C) Copyright 2001\n- * Dave Ellis, SIXNET, dge@sixnetio.com\n- *\n- */\n-\n-Using autoboot configuration options\n-====================================\n-\n-The basic autoboot configuration options are documented in the main\n-U-Boot README. See it for details. They are:\n-\n- bootdelay\n- bootcmd\n- CONFIG_BOOTDELAY\n- CONFIG_BOOTCOMMAND\n-\n-Some additional options that make autoboot safer in a production\n-product are documented here.\n-\n-Why use them?\n--------------\n-\n-The basic autoboot feature allows a system to automatically boot to\n-the real application (such as Linux) without a user having to enter\n-any commands. If any key is pressed before the boot delay time\n-expires, U-Boot stops the autoboot process, gives a U-Boot prompt\n-and waits forever for a command. That's a good thing if you pressed a\n-key because you wanted to get the prompt.\n-\n-It's not so good if the key press was a stray character on the\n-console serial port, say because a user who knows nothing about\n-U-Boot pressed a key before the system had time to boot. It's even\n-worse on an embedded product that doesn't have a console during\n-normal use. The modem plugged into that console port sends a\n-character at the wrong time and the system hangs, with no clue as to\n-why it isn't working.\n-\n-You might want the system to autoboot to recover after an external\n-configuration program stops autoboot. If the configuration program\n-dies or loses its connection (modems can disconnect at the worst\n-time) U-Boot will patiently wait forever for it to finish.\n-\n-These additional configuration options can help provide a system that\n-boots when it should, but still allows access to U-Boot.\n-\n-What they do\n-------------\n-\n- CONFIG_BOOT_RETRY_TIME\n- CONFIG_BOOT_RETRY_MIN\n-\n- \"bootretry\" environment variable\n-\n-\tThese options determine what happens after autoboot is\n-\tstopped and U-Boot is waiting for commands.\n-\n-\tCONFIG_BOOT_RETRY_TIME must be defined to enable the boot\n-\tretry feature. If the environment variable \"bootretry\" is\n-\tfound then its value is used, otherwise the retry timeout is\n-\tCONFIG_BOOT_RETRY_TIME. CONFIG_BOOT_RETRY_MIN is optional and\n-\tdefaults to CONFIG_BOOT_RETRY_TIME. All times are in seconds.\n-\n-\tIf the retry timeout is negative, the U-Boot command prompt\n-\tnever times out. Otherwise it is forced to be at least\n-\tCONFIG_BOOT_RETRY_MIN seconds. If no valid U-Boot command is\n-\tentered before the specified time the boot delay sequence is\n-\trestarted. Each command that U-Boot executes restarts the\n-\ttimeout.\n-\n-\tIf CONFIG_BOOT_RETRY_TIME < 0 the feature is there, but\n-\tdoesn't do anything unless the environment variable\n-\t\"bootretry\" is >= 0.\n-\n- CONFIG_AUTOBOOT_KEYED\n- CONFIG_AUTOBOOT_KEYED_CTRLC\n- CONFIG_AUTOBOOT_PROMPT\n- CONFIG_AUTOBOOT_DELAY_STR\n- CONFIG_AUTOBOOT_STOP_STR\n-\n- \"bootdelaykey\" environment variable\n- \"bootstopkey\"\t environment variable\n-\n-\tThese options give more control over stopping autoboot. When\n-\tthey are used a specific character or string is required to\n-\tstop or delay autoboot.\n-\n-\tDefine CONFIG_AUTOBOOT_KEYED (no value required) to enable\n-\tthis group of options.\tCONFIG_AUTOBOOT_DELAY_STR,\n-\tCONFIG_AUTOBOOT_STOP_STR or both should be specified (or\n-\tspecified by the corresponding environment variable),\n-\totherwise there is no way to stop autoboot.\n-\n-\tCONFIG_AUTOBOOT_PROMPT is displayed before the boot delay\n-\tselected by CONFIG_BOOTDELAY starts. If it is not defined\n-\tthere is no output indicating that autoboot is in progress.\n-\n-\tNote that CONFIG_AUTOBOOT_PROMPT is used as the (only)\n-\targument to a printf() call, so it may contain '%' format\n-\tspecifications, provided that it also includes, sepearated by\n-\tcommas exactly like in a printf statement, the required\n-\targuments. It is the responsibility of the user to select only\n-\tsuch arguments that are valid in the given context. A\n-\treasonable prompt could be defined as\n-\n-\t\t#define CONFIG_AUTOBOOT_PROMPT \\\n-\t\t\t\"autoboot in %d seconds\\n\",bootdelay\n-\n-\tIf CONFIG_AUTOBOOT_DELAY_STR or \"bootdelaykey\" is specified\n-\tand this string is received from console input before\n-\tautoboot starts booting, U-Boot gives a command prompt. The\n-\tU-Boot prompt will time out if CONFIG_BOOT_RETRY_TIME is\n-\tused, otherwise it never times out.\n-\n-\tIf CONFIG_AUTOBOOT_STOP_STR or \"bootstopkey\" is specified and\n-\tthis string is received from console input before autoboot\n-\tstarts booting, U-Boot gives a command prompt. The U-Boot\n-\tprompt never times out, even if CONFIG_BOOT_RETRY_TIME is\n-\tused.\n-\n-\tThe string recognition is not very sophisticated. If a\n-\tpartial match is detected, the first non-matching character\n-\tis checked to see if starts a new match. There is no check\n-\tfor a shorter partial match, so it's best if the first\n-\tcharacter of a key string does not appear in the rest of the\n-\tstring.\n-\n-\tThe CONFIG_AUTOBOOT_KEYED_CTRLC #define allows for the boot\n-\tsequence to be interrupted by ctrl-c, in addition to the\n-\t\"bootdelaykey\" and \"bootstopkey\". Setting this variable\n-\tprovides an escape sequence from the limited \"password\"\n-\tstrings.\n-\n- CONFIG_AUTOBOOT_ENCRYPTION\n-\n- \"bootstopkeysha256\"\tenvironment variable\n-\n-\t- Hash value of the input which unlocks the device and\n-\t stops autoboot.\n-\n-\tThis option allows a string to be entered into U-Boot to stop the\n-\tautoboot. The string itself is hashed and compared against the hash\n-\tin the environment variable 'bootstopkeysha256'. If it matches then\n-\tboot stops and a command-line prompt is presented.\n-\n-\tThis provides a way to ship a secure production device which can also\n-\tbe accessed at the U-Boot command line.\n-\n- CONFIG_RESET_TO_RETRY\n-\n-\t(Only effective when CONFIG_BOOT_RETRY_TIME is also set)\n-\tAfter the countdown timed out, the board will be reset to restart\n-\tagain.\n-\n- CONFIG_AUTOBOOT_USE_MENUKEY\n- CONFIG_AUTOBOOT_MENUKEY\n-\n-\tIf this key is pressed to stop autoboot, then the commands in the\n-\tenvironment variable 'menucmd' will be executed before boot starts.\n-\tFor example, 33 means \"!\" in ASCII, so pressing ! at boot would take\n-\tthis action.\ndiff --git a/doc/usage/autoboot.rst b/doc/usage/autoboot.rst\nnew file mode 100644\nindex 00000000000..3b6f040008b\n--- /dev/null\n+++ b/doc/usage/autoboot.rst\n@@ -0,0 +1,149 @@\n+.. SPDX-License-Identifier: GPL-2.0+\n+..\n+.. (C) Copyright 2001\n+.. Dave Ellis, SIXNET, dge@sixnetio.com\n+\n+Using autoboot configuration options\n+====================================\n+\n+The basic autoboot configuration options are documented in the main\n+U-Boot README. See it for details. They are:\n+\n+::\n+\n+ bootdelay\n+ bootcmd\n+ CONFIG_BOOTDELAY\n+ CONFIG_BOOTCOMMAND\n+\n+Some additional options that make autoboot safer in a production\n+product are documented here.\n+\n+Why use them?\n+-------------\n+\n+The basic autoboot feature allows a system to automatically boot to\n+the real application (such as Linux) without a user having to enter\n+any commands. If any key is pressed before the boot delay time\n+expires, U-Boot stops the autoboot process, gives a U-Boot prompt\n+and waits forever for a command. That's a good thing if you pressed a\n+key because you wanted to get the prompt.\n+\n+It's not so good if the key press was a stray character on the\n+console serial port, say because a user who knows nothing about\n+U-Boot pressed a key before the system had time to boot. It's even\n+worse on an embedded product that doesn't have a console during\n+normal use. The modem plugged into that console port sends a\n+character at the wrong time and the system hangs, with no clue as to\n+why it isn't working.\n+\n+You might want the system to autoboot to recover after an external\n+configuration program stops autoboot. If the configuration program\n+dies or loses its connection (modems can disconnect at the worst\n+time) U-Boot will patiently wait forever for it to finish.\n+\n+These additional configuration options can help provide a system that\n+boots when it should, but still allows access to U-Boot.\n+\n+What they do\n+------------\n+\n+CONFIG_BOOT_RETRY_TIME, CONFIG_BOOT_RETRY_MIN, \"bootretry\" environment variable\n+ These options determine what happens after autoboot is\n+ stopped and U-Boot is waiting for commands.\n+ \n+ CONFIG_BOOT_RETRY_TIME must be defined to enable the boot\n+ retry feature. If the environment variable \"bootretry\" is\n+ found then its value is used, otherwise the retry timeout is\n+ CONFIG_BOOT_RETRY_TIME. CONFIG_BOOT_RETRY_MIN is optional and\n+ defaults to CONFIG_BOOT_RETRY_TIME. All times are in seconds.\n+ \n+ If the retry timeout is negative, the U-Boot command prompt\n+ never times out. Otherwise it is forced to be at least\n+ CONFIG_BOOT_RETRY_MIN seconds. If no valid U-Boot command is\n+ entered before the specified time the boot delay sequence is\n+ restarted. Each command that U-Boot executes restarts the\n+ timeout.\n+ \n+ If CONFIG_BOOT_RETRY_TIME < 0 the feature is there, but\n+ doesn't do anything unless the environment variable\n+ \"bootretry\" is >= 0.\n+\n+CONFIG_AUTOBOOT_PROMPT\n+ CONFIG_AUTOBOOT_PROMPT is displayed before the boot delay\n+ selected by CONFIG_BOOTDELAY starts, if CONFIG_AUTOBOOT_KEYED\n+ is defined. Else it is displayed during the autoboot countdown.\n+\n+ Note that CONFIG_AUTOBOOT_PROMPT is used as first\n+ argument to a printf() call, along with the '%d' boot delay countdown,\n+ so it may contain '%' format specifications, provided that it\n+ also includes, sepearated by commas exactly like in a printf\n+ statement, the required arguments. It is the responsibility\n+ of the user to select only such arguments that are valid in\n+ the given context. A reasonable prompt could be defined as\n+\n+ ::\n+\n+ #define CONFIG_AUTOBOOT_PROMPT \\\n+ \"\\rBooting in %d seconds\"\n+\n+CONFIG_RESET_TO_RETRY\n+ (Only effective when CONFIG_BOOT_RETRY_TIME is also set)\n+ After the countdown timed out, the board will be reset to restart\n+ again.\n+\n+CONFIG_AUTOBOOT_USE_MENUKEY, CONFIG_AUTOBOOT_MENUKEY\n+ If this key is pressed to stop autoboot, then the commands in the\n+ environment variable 'menucmd' will be executed before boot starts.\n+ For example, 33 means \"!\" in ASCII, so pressing ! at boot would take\n+ this action.\n+\n+\n+Controlling autoboot\n+~~~~~~~~~~~~~~~~~~~~\n+\n+The following options give more control over stopping autoboot. When\n+they are used a specific character or string is required to stop or\n+delay autoboot.\n+Define CONFIG_AUTOBOOT_KEYED (no value required) to enable this group\n+of options.\n+\n+CONFIG_AUTOBOOT_DELAY_STR, CONFIG_AUTOBOOT_STOP_STR or both\n+should be specified (or specified by the corresponding environment variable),\n+otherwise there is no way to stop autoboot.\n+\n+CONFIG_AUTOBOOT_DELAY_STR, \"bootdelaykey\" environment variable\n+ If specified and this string is received from console input\n+ before autoboot starts booting, U-Boot gives a command prompt.\n+ The U-Boot prompt will time out if CONFIG_BOOT_RETRY_TIME is\n+ used, otherwise it never times out. It should be specified\n+ otherwise there is no way to stop autoboot.\n+\n+CONFIG_AUTOBOOT_STOP_STR, \"bootstopkey\" environment variable\n+ If specified and this string is received from console input\n+ before autoboot starts booting, U-Boot gives a command prompt.\n+ The U-Boot prompt never times out, even if CONFIG_BOOT_RETRY_TIME\n+ is used.\n+\n+The string recognition is not very sophisticated. If a\n+partial match is detected, the first non-matching character\n+is checked to see if starts a new match. There is no check\n+for a shorter partial match, so it's best if the first\n+character of a key string does not appear in the rest of the\n+string.\n+\n+CONFIG_AUTOBOOT_KEYED_CTRLC\n+ The CONFIG_AUTOBOOT_KEYED_CTRLC #define allows for the boot\n+ sequence to be interrupted by ctrl-c, in addition to the\n+ \"bootdelaykey\" and \"bootstopkey\". Setting this variable\n+ provides an escape sequence from the limited \"password\"\n+ strings.\n+\n+CONFIG_AUTOBOOT_ENCRYPTION, \"bootstopkeysha256\" environment variable\n+ This option allows a string to be entered into U-Boot to stop the\n+ autoboot. The string itself is hashed and compared against the hash\n+ in the environment variable 'bootstopkeysha256'. If it matches then\n+ boot stops and a command-line prompt is presented.\n+\n+ This provides a way to ship a secure production device which can also\n+ be accessed at the U-Boot command line.\ndiff --git a/doc/usage/index.rst b/doc/usage/index.rst\nindex 6f477b842ca..35b9f4612f4 100644\n--- a/doc/usage/index.rst\n+++ b/doc/usage/index.rst\n@@ -4,6 +4,7 @@ Use U-Boot\n .. toctree::\n :maxdepth: 1\n \n+ autoboot\n spl_boot\n blkmap\n dfu\n", "prefixes": [ "v4", "3/4" ] }