{"id":2223561,"url":"http://patchwork.ozlabs.org/api/patches/2223561/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org/","project":{"id":18,"url":"http://patchwork.ozlabs.org/api/projects/18/?format=json","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":"<20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>","list_archive_url":null,"date":"2026-04-15T14:32:33","name":"[v3,3/3] 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=json","name":"Ferass El Hafidi","email":"funderscore@postmarketos.org"},"delegate":{"id":3651,"url":"http://patchwork.ozlabs.org/api/users/3651/?format=json","username":"trini","first_name":"Tom","last_name":"Rini","email":"trini@ti.com"},"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org/mbox/","series":[{"id":500008,"url":"http://patchwork.ozlabs.org/api/series/500008/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=500008","date":"2026-04-15T14:32:30","name":"Autoboot prompt customization and bootmenu cosmetics","version":3,"mbox":"http://patchwork.ozlabs.org/series/500008/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2223561/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2223561/checks/","tags":{},"related":[],"headers":{"Return-Path":"","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=McPFapHK;\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=\"McPFapHK\";\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 4fwlk40m45z1yCv\n\tfor ; Thu, 16 Apr 2026 01:41:32 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id DD97D8407E;\n\tWed, 15 Apr 2026 17:41:07 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id B653384105; Wed, 15 Apr 2026 17:41:04 +0200 (CEST)","from out-170.mta0.migadu.com (out-170.mta0.migadu.com\n [IPv6:2001:41d0:1004:224b::aa])\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 3184983B99\n for ; Wed, 15 Apr 2026 17:40:58 +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 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=1776267657;\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=McPFapHK9YcOpMUhu+ymWJDF0fpVvMQYHPsLYJCNDIcixy+vRv2O09mcFr6Y4hvUC6bgRY\n 0A1JE4ntFAqEcoUfFHqkY5pvEmSRIhZ4jhPljqXrg8MjGY817XIEyBe6h67gn9+NaWvfrY\n lgQw3v0JX0lOU5f/im1dTOdu0Sq8wiehmWCxv8qRnO75OP12WiO6K8e4lmuLYes/d1SOaG\n kLDIBkaEUGGbzcZZbq48h2TRQVfyXmZUvb0zfz/H6LlBlElKavArPuDcExtMQcbbZSdx6r\n IQ3Fl1rT5ywMR6lUwZZ1rCkdxoFm5PkiorNeSTaRyyNRGJa5vnRKcdW+/xnxcg==","From":"Ferass El Hafidi ","Date":"Wed, 15 Apr 2026 14:32:33 +0000","Subject":"[PATCH v3 3/3] doc: usage: convert autoboot README to rST","MIME-Version":"1.0","Content-Type":"text/plain; charset=\"utf-8\"","Content-Transfer-Encoding":"7bit","Message-Id":"<20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>","References":"<20260415-ui-cosmetics-v3-0-aa8308a47e33@postmarketos.org>","In-Reply-To":"<20260415-ui-cosmetics-v3-0-aa8308a47e33@postmarketos.org>","To":"u-boot@lists.denx.de","Cc":"Tom Rini , Quentin Schulz ,\n \"Kory Maincent (TI.com)\" ,\n Simon Glass ,\n Mattijs Korpershoek ,\n Anshul Dalal , Heinrich Schuchardt ,\n Martin Schwan , David Zang ,\n Sam Protsenko ,\n Christian Marangi ,\n Ferass El Hafidi ","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/ZANAwAKAYSvy9DXiZoDAcsmYgBp37GEB+Uq3pmUlKCva8caWmkSAvOMLK/+RPgcm\n NwFT/k+qU+JAjMEAAEKAB0WIQQDAbw3+1VcrP15i+6Er8vQ14maAwUCad+xhAAKCRCEr8vQ14ma\n Aww2D/0a8QW5YUJtRjPOhcjvThGFpEuaAJY6AREoqJADXawfqSdgaGDPG238C2OwxK8bYyhhWLC\n H6rWds6Vd+z8aJR+jKe8NQk7NLbIwb31Q2w/kSdvYnd9JMXdepxtzyluDpWNTOgGY15mGD1FXe1\n IViLsctxfSFRSFWwntLFF+Q2M8vCJq7e/76nJgIild7wdHD1m7jnV/8i6QEeAn1yh9CYu+MIbo1\n PC4YAhChyH922AgLd1UBw60wJjjsGb3aglgEZHXVaP0vwpZFm6k5FF7bE0XH7+4BpBBewuMVUZN\n /J9/483hqFU5TnITXUq9PXnr+BaFHEfNf6ZZnvOaIyhe4YKYr6CzC0qFQK4xm0qPrwSOXYNQRHy\n RcqfCYkpem9pfjkawX4Gjmb4dAaKO1K649sORSSM8M/GDzHy5+K04G4DYAT8I/Gc27u3tuk0rS7\n On8vpQXno5HHoGNP3C1l9WQ5WQnXmLqGve6vY/8Wc3o0rRV4BniQZxf2yj+LCGewz8pW79zLrGo\n XIFsSLCRQ1VxsTrp0ULKOhXdPFRnE6evXQmqWCk3jUFucFK+szjzCQvQ2DWFeqri4KgkPmqspd7\n EX6vEayTVCitgW/8f/YBg5creNh0k/VRiBySIh5GH4iRZXQHK1hkFQ7RSo/WcDyjyunJId111OY\n bVXdOs9KyJbuXlg==","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 ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"u-boot-bounces@lists.denx.de","Sender":"\"U-Boot\" ","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 \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":["v3","3/3"]}