Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2223561/?format=api
{ "id": 2223561, "url": "http://patchwork.ozlabs.org/api/patches/2223561/?format=api", "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=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": "<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=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/20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org/mbox/", "series": [ { "id": 500008, "url": "http://patchwork.ozlabs.org/api/series/500008/?format=api", "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": "<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=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 <incoming@patchwork.ozlabs.org>; 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 <u-boot@lists.denx.de>; 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 <funderscore@postmarketos.org>", "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 <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/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 <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": [ "v3", "3/3" ] }