[{"id":3677789,"web_url":"http://patchwork.ozlabs.org/comment/3677789/","msgid":"<61DCA2CF-A66E-47C5-8921-9747FAC8C75B@gmx.de>","list_archive_url":null,"date":"2026-04-15T18:57:36","subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","submitter":{"id":61270,"url":"http://patchwork.ozlabs.org/api/people/61270/","name":"Heinrich Schuchardt","email":"xypron.glpk@gmx.de"},"content":"Am 15. April 2026 16:32:33 MESZ schrieb Ferass El Hafidi :\n>Convert the plain text autoboot documentation into rST, so it is visible\n>in the public docs. Also decouple CONFIG_AUTOBOOT_PROMPT from\n>CONFIG_AUTOBOOT_KEYED in the documentation to reflect previous commits.\n>\n>Signed-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(-)\n>\n>diff --git a/doc/README.autoboot b/doc/README.autoboot\n>deleted file mode 100644\n>index 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.\n>diff --git a/doc/usage/autoboot.rst b/doc/usage/autoboot.rst\n>new file mode 100644\n>index 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.\n\nI can't find the word autoboot there. Anyway all autoboot options should be documented in this file.\n\n 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\nThere recently was a patch on the mailing list to clear stdin at least for serial input.\n\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\nConstants starting with CONFIG_ may only be defined in Kconfig files.\n\nBest regards\n\nHeinrich\n\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.\n>diff --git a/doc/usage/index.rst b/doc/usage/index.rst\n>index 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>","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 secure) header.d=gmx.de header.i=xypron.glpk@gmx.de header.a=rsa-sha256\n header.s=s31663417 header.b=N2eCxU6f;\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=gmx.de","phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de","phobos.denx.de;\n\tdkim=pass (2048-bit key;\n secure) header.d=gmx.de header.i=xypron.glpk@gmx.de header.b=\"N2eCxU6f\";\n\tdkim-atps=neutral","phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=gmx.de","phobos.denx.de;\n spf=pass smtp.mailfrom=xypron.glpk@gmx.de"],"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 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fwr4k0cnFz1yCv\n\tfor ; Thu, 16 Apr 2026 04:57:58 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 45D4983C2B;\n\tWed, 15 Apr 2026 20:57:55 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id 5A49483EEF; Wed, 15 Apr 2026 20:57:53 +0200 (CEST)","from mout.gmx.net (mout.gmx.net [212.227.15.19])\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 CDDA783B99\n for ; Wed, 15 Apr 2026 20:57:50 +0200 (CEST)","from client.hidden.invalid by mail.gmx.net (mrgmx005\n [212.227.17.190]) with ESMTPSA (Nemesis) id 1MjS9I-1vjp971CIc-00ciFJ; Wed, 15\n Apr 2026 20:57:39 +0200"],"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,FREEMAIL_FROM,\n RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,\n RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED,\n SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.de;\n s=s31663417; t=1776279459; x=1776884259; i=xypron.glpk@gmx.de;\n bh=oFCA+a4pYyrej7sDh/nQDsnAwb6aE/ui2KOSVp/NUVc=;\n h=X-UI-Sender-Class:Date:From:To:CC:Subject:In-Reply-To:References:\n Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:\n content-transfer-encoding:content-type:date:from:message-id:\n mime-version:reply-to:subject:to;\n b=N2eCxU6fBJ0uAZ6kxGr774RrHlqFdwjD03R8unQ/WKj7K9blvmPtvGDpgt11pO4Y\n K9lNdoH+hFQX6NwOfBa5U3V27XWzTFe1MyigKBIfHGlNBFaW+DD1uzK/nyUWeD6YG\n rOgOQvuMBxLolDkUmN0PBG2R17GuUMPGT0PWsR1kl0+EMo97HL6hmVUHyUWtFM6NC\n fC5t2x1YPGfG2K32R4vprCPLYSZlR+IH146jAkTlNScqEvf7oKJHfyNFr11l7vNRq\n gfwQd9WgzqRlcMgfe2ndf7bLyJlUYIiwX9S2yPla0v49dgiJqtub1UPcmiELhDshb\n 1ZVyXdJcbcTZFhGweA==","X-UI-Sender-Class":"724b4f7f-cbec-4199-ad4e-598c01a50d3a","Date":"Wed, 15 Apr 2026 20:57:36 +0200","From":"Heinrich Schuchardt ","To":"Ferass El Hafidi , u-boot@lists.denx.de","CC":"Tom Rini , Quentin Schulz ,\n \"Kory Maincent (TI.com)\" ,\n Simon Glass ,\n Mattijs Korpershoek , Anshul Dalal ,\n Martin Schwan , David Zang ,\n Sam Protsenko ,\n Christian Marangi ","Subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","User-Agent":"Thunderbird for Android","In-Reply-To":"<20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>","References":"<20260415-ui-cosmetics-v3-0-aa8308a47e33@postmarketos.org>\n <20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>","Message-ID":"<61DCA2CF-A66E-47C5-8921-9747FAC8C75B@gmx.de>","MIME-Version":"1.0","Content-Type":"text/plain;\n charset=utf-8","Content-Transfer-Encoding":"quoted-printable","X-Provags-ID":"V03:K1:/e8YSFMxbuDPUkLpFeVf3nVpw4j9xeUY2MWbXBxMhWGkBmQEe0d\n whTGA4Jl7yMjROfilrQJy/a9ZCcfNlTwNo4/AoYFBkTiGCiGaXC0NgcCOxkTbp/ebrxP9Gd\n jRMBExY3akExDpOXFrdghTzzPEF8MpRBAVDsl6JJba5uGyy8Lcs0CI3RTCdGvs5GSjb4Yk6\n pbY3+/fyGLf2BBmWMjCWw==","UI-OutboundReport":"notjunk:1;M01:P0:tWLLjP36ub0=;DxSwrxjb4FdTdqttWVhQVMoVdFH\n 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\n Ag7JUA==","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"}},{"id":3677808,"web_url":"http://patchwork.ozlabs.org/comment/3677808/","msgid":"","list_archive_url":null,"date":"2026-04-15T20:10:43","subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","submitter":{"id":90020,"url":"http://patchwork.ozlabs.org/api/people/90020/","name":"Ferass El Hafidi","email":"funderscore@postmarketos.org"},"content":"Hi,\n\nOn Wed, 15 Apr 2026 18:57, Heinrich Schuchardt wrote:\n>Am 15. April 2026 16:32:33 MESZ schrieb Ferass El Hafidi :\n>>Convert the plain text autoboot documentation into rST, so it is visible\n>>in the public docs. Also decouple CONFIG_AUTOBOOT_PROMPT from\n>>CONFIG_AUTOBOOT_KEYED in the documentation to reflect previous commits.\n>>\n>>Signed-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(-)\n>>\n>>diff --git a/doc/README.autoboot b/doc/README.autoboot\n>>deleted file mode 100644\n>>index 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.\n>>diff --git a/doc/usage/autoboot.rst b/doc/usage/autoboot.rst\n>>new file mode 100644\n>>index 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.\n>\n>I can't find the word autoboot there. Anyway all autoboot options should be documented in this file.\n>\n\nThis was taken from the OG README.autoboot file\n\n> 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>There recently was a patch on the mailing list to clear stdin at least for serial input.\n>\n\nSame for this\n\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>Constants starting with CONFIG_ may only be defined in Kconfig files.\n>\n\nAnd this.\n\nDo you think it makes sense to rework autoboot documentation with these\nchanges or would it be out of scope for this patch series? The only\nchanges I did was to convert to rST and move AUTOBOOT_PROMPT docs\noutside of KEYED (as per patch 1/3).\n\n--\nBest regards,\nFerass ","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=Xa2BNFKl;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=85.214.62.61; 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=\"Xa2BNFKl\";\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 [85.214.62.61])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fwsmK0mZ6z1yCv\n\tfor ; Thu, 16 Apr 2026 06:13:53 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id EB60B83EEF;\n\tWed, 15 Apr 2026 22:13:48 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id 25BEA83FFA; Wed, 15 Apr 2026 22:13:47 +0200 (CEST)","from out-172.mta0.migadu.com (out-172.mta0.migadu.com\n [91.218.175.172])\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 1DDF483B99\n for ; Wed, 15 Apr 2026 22:13:44 +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","Date":"Wed, 15 Apr 2026 20:10:43 +0000","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=postmarketos.org;\n s=key1; t=1776284023;\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=nfRAsYGIb6MUOd57d2o2LnDV3QprCmVbDwEbd8UluV4=;\n b=Xa2BNFKl2OY33749El2iCPg30ClwTCQHxumumhHQz/lE6aSPjufl9+hYleqRzQ5IzagdEq\n HIdO4w+Bo+FsjC6IkAG6y/lMufaClwTBoOrTMflQMbNlQiTpG4WXJjeB6bYRRXlUeJ6qAD\n 9gnxaOwH6I/mwwDqXBAcfuQ9QqsEiSpqSBNbLIcbNgBCU50AHpdNFQ31bq+HF4EPi9M35o\n Z61j/kWYkJ+DcAHQKQoC2CtFt6aB1o++iqZh2UWVKaXqjGd37ZCFFVRcw8NSPjDFnk7n/k\n tP95EakJC2o7QJqoTQAj++5tRQY93C0YM+XELQsfOft0PaIOELOuX/SRwfVU7A==","X-Report-Abuse":"Please report any abuse attempt to abuse@migadu.com and\n include these headers.","From":"Ferass El Hafidi ","To":"Heinrich Schuchardt , u-boot@lists.denx.de","Cc":"Tom Rini , Quentin Schulz ,\n Kory Maincent (TI.com) ,\n Simon Glass ,\n Mattijs Korpershoek ,\n Anshul Dalal , Martin Schwan ,\n David Zang ,\n Sam Protsenko ,\n Christian Marangi ","Subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","References":"<20260415-ui-cosmetics-v3-0-aa8308a47e33@postmarketos.org>\n <20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>\n <61DCA2CF-A66E-47C5-8921-9747FAC8C75B@gmx.de>","In-Reply-To":"<61DCA2CF-A66E-47C5-8921-9747FAC8C75B@gmx.de>","Message-ID":"","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Content-Type":"text/plain; charset=utf-8; format=flowed","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"}},{"id":3677852,"web_url":"http://patchwork.ozlabs.org/comment/3677852/","msgid":"<2D15A5D4-D938-4DDD-801A-84F7B0230E55@gmx.de>","list_archive_url":null,"date":"2026-04-15T23:17:44","subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","submitter":{"id":61270,"url":"http://patchwork.ozlabs.org/api/people/61270/","name":"Heinrich Schuchardt","email":"xypron.glpk@gmx.de"},"content":"Am 15. April 2026 22:10:43 MESZ schrieb Ferass El Hafidi :\n>Hi,\n>\n>On Wed, 15 Apr 2026 18:57, Heinrich Schuchardt wrote:\n>> Am 15. April 2026 16:32:33 MESZ schrieb Ferass El Hafidi :\n>>> Convert the plain text autoboot documentation into rST, so it is visible\n>>> in the public docs. Also decouple CONFIG_AUTOBOOT_PROMPT from\n>>> CONFIG_AUTOBOOT_KEYED in the documentation to reflect previous commits.\n>>> \n>>> Signed-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(-)\n>>> \n>>> diff --git a/doc/README.autoboot b/doc/README.autoboot\n>>> deleted file mode 100644\n>>> index 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.\n>>> diff --git a/doc/usage/autoboot.rst b/doc/usage/autoboot.rst\n>>> new file mode 100644\n>>> index 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.\n>> \n>> I can't find the word autoboot there. Anyway all autoboot options should be documented in this file.\n>> \n>\n>This was taken from the OG README.autoboot file\n>\n>> 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>> There recently was a patch on the mailing list to clear stdin at least for serial input.\n>> \n>\n>Same for this\n>\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>>> + + 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>>> + + 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>>> + + 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>> Constants starting with CONFIG_ may only be defined in Kconfig files.\n>> \n>\n>And this.\n>\n>Do you think it makes sense to rework autoboot documentation with these\n>changes or would it be out of scope for this patch series? The only\n>changes I did was to convert to rST and move AUTOBOOT_PROMPT docs\n>outside of KEYED (as per patch 1/3).\n\nI would suggest to have one patch for the conversion and another patch to correct the content.\n\nBest regards\n\nHeinrich\n\n>\n>--\n>Best regards,\n>Ferass ","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 secure) header.d=gmx.de header.i=xypron.glpk@gmx.de header.a=rsa-sha256\n header.s=s31663417 header.b=W3FT07wo;\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=gmx.de","phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de","phobos.denx.de;\n\tdkim=pass (2048-bit key;\n secure) header.d=gmx.de header.i=xypron.glpk@gmx.de header.b=\"W3FT07wo\";\n\tdkim-atps=neutral","phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=gmx.de","phobos.denx.de;\n spf=pass smtp.mailfrom=xypron.glpk@gmx.de"],"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 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fwxs62BD3z1yG9\n\tfor ; Thu, 16 Apr 2026 09:18:18 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 31741841C2;\n\tThu, 16 Apr 2026 01:18:09 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id 66CC7841C8; Thu, 16 Apr 2026 01:18:06 +0200 (CEST)","from mout.gmx.net (mout.gmx.net [212.227.17.20])\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 F18408419C\n for ; Thu, 16 Apr 2026 01:18:03 +0200 (CEST)","from client.hidden.invalid by mail.gmx.net (mrgmx104\n [212.227.17.168]) with ESMTPSA (Nemesis) id 1MKsnF-1vzBXV1F8f-00YkjL; Thu, 16\n Apr 2026 01:17:48 +0200"],"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,FREEMAIL_FROM,\n RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,\n RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED,\n SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.de;\n s=s31663417; t=1776295068; x=1776899868; i=xypron.glpk@gmx.de;\n bh=+oCBpqN0F/Q52aMj+fQ5X/dM4gyYhp21sZIVG7/7G5I=;\n h=X-UI-Sender-Class:Date:From:To:CC:Subject:In-Reply-To:References:\n Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc:\n content-transfer-encoding:content-type:date:from:message-id:\n mime-version:reply-to:subject:to;\n b=W3FT07woE+4PxlvGOXw6NUP31lkGwogxmgsuBmBez/jHcLtGKtrnsZx1ve4KnGNW\n Zm7kJsLHibtMk40IWrVPOXt8qUcbUoQVhkIixNeydMADQktryvzsZETkyLrY5HzWX\n mYKMOAcHbt1lwuSKXUh75FLsBFUCg1cGQdxhczk9+SbmCp/lLCdbWftTVIzGWt7hp\n OeupQ6nbyqTeRXYZ9VZWgnCbIfn1EjQ5fsTfl56AIxMDtwena4Xwdc89rOr8MO/lJ\n h4aUAl9TZAizhQhbZBysNtZIb2sYS44pgARnG4KOvuaeEnoRdj01I/JXIDHxRqoJC\n 5MGvNfWm8HL0AaLflA==","X-UI-Sender-Class":"724b4f7f-cbec-4199-ad4e-598c01a50d3a","Date":"Thu, 16 Apr 2026 01:17:44 +0200","From":"Heinrich Schuchardt ","To":"Ferass El Hafidi , u-boot@lists.denx.de","CC":"Tom Rini , Quentin Schulz ,\n Kory Maincent , Simon Glass ,\n Mattijs Korpershoek ,\n Anshul Dalal ,\n Martin Schwan , David Zang ,\n Sam Protsenko ,\n Christian Marangi ","Subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","User-Agent":"Thunderbird for Android","In-Reply-To":"","References":"<20260415-ui-cosmetics-v3-0-aa8308a47e33@postmarketos.org>\n <20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>\n <61DCA2CF-A66E-47C5-8921-9747FAC8C75B@gmx.de>\n ","Message-ID":"<2D15A5D4-D938-4DDD-801A-84F7B0230E55@gmx.de>","MIME-Version":"1.0","Content-Type":"text/plain;\n charset=utf-8","Content-Transfer-Encoding":"quoted-printable","X-Provags-ID":"V03:K1:Jtfk8cqJDbRzkRKmZLstXaoxeDAO4WYdGow+FL/X+ffKwescKYH\n hSEtEKljuVyKvLfDCi9NFsQ5wgnZ45BuIV83p0+fmaVBFbrt2/xSlbjE8UO+wdoQgfDhOhT\n sV1alJik3j6hOdIujHhftFlDndUiqH5VHCyzKObDe2qvHf+1SWBBwltGyexxYOHDrVYxdTL\n DwRur+l/L5ZohxGwtXklg==","UI-OutboundReport":"notjunk:1;M01:P0:Xl0IMIP6TqA=;IrHc0ZCIH3GhEBh3JsGMUXKWlO2\n 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\n glgjzg==","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"}},{"id":3678207,"web_url":"http://patchwork.ozlabs.org/comment/3678207/","msgid":"","list_archive_url":null,"date":"2026-04-16T14:07:50","subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","submitter":{"id":90020,"url":"http://patchwork.ozlabs.org/api/people/90020/","name":"Ferass El Hafidi","email":"funderscore@postmarketos.org"},"content":"Hi Heinrich,\n\nOn Wed, 15 Apr 2026 23:17, Heinrich Schuchardt wrote:\n><...>\n>>Do you think it makes sense to rework autoboot documentation with these\n>>changes or would it be out of scope for this patch series? The only\n>>changes I did was to convert to rST and move AUTOBOOT_PROMPT docs\n>>outside of KEYED (as per patch 1/3).\n>\n>I would suggest to have one patch for the conversion and another patch to correct the content.\n>\n\nOK, makes sense to me. The stdin flush patch (which I suppose is \nhttps://lore.kernel.org/u-boot/20260413152526.153605-2-gregor.herburger@linutronix.de/)\nseems to not be merged yet so I won't adjust the docs for that now, if\nthat's fine for you.\n\nThank you for your feedback!\n\n--\nBest regards,\nFerass","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=TfscIOV5;\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=\"TfscIOV5\";\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 4fxKhw4c7lz1yHP\n\tfor ; Fri, 17 Apr 2026 00:12:32 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id B4EB4841C2;\n\tThu, 16 Apr 2026 16:12:29 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id 3D629841D5; Thu, 16 Apr 2026 16:12:28 +0200 (CEST)","from out-173.mta0.migadu.com (out-173.mta0.migadu.com\n [IPv6:2001:41d0:1004:224b::ad])\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 14213840AB\n for ; Thu, 16 Apr 2026 16:12:24 +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","Date":"Thu, 16 Apr 2026 14:07:50 +0000","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=postmarketos.org;\n s=key1; t=1776348744;\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=xhlz/RfXe7mesvWuW31IHFLDPa0Xv2PkIAvh7INWNE8=;\n b=TfscIOV5AD+O1rjwSHlU51KrFMIA8EZ4W1s//fUwXMJxc6wKMcemOqzl0B4GoDMp6ZD2Xi\n n1+Ad10exeU19njNHDPOytTR4vjX7dgs/JUm9ByMuIOm2knmzL90qgs6EGOu4PrLZSNCFQ\n e6p6Qxb0PQMd8taVfsoOd8RLj6NL7mwra8ymbHQvPmQdRsnLu2q21OWK9L/+9llTB9sP0A\n X0jURl8t36pdiWtoTsOKknu1mxgKQ+bX0wuQZ4oI74c61ECZtmMiHX9GXRlml1evig6ZU3\n tEGW94omtAnudewAfyn7ktg1ylrKbfS+MgJAALrVKkFNBhuxlctCzFINoVLmSQ==","X-Report-Abuse":"Please report any abuse attempt to abuse@migadu.com and\n include these headers.","From":"Ferass El Hafidi ","To":"Heinrich Schuchardt , u-boot@lists.denx.de","Cc":"Tom Rini , Quentin Schulz ,\n Kory Maincent , Simon Glass ,\n Mattijs Korpershoek , Anshul Dalal ,\n Martin Schwan , David Zang ,\n Sam Protsenko ,\n Christian Marangi ","Subject":"Re: [PATCH v3 3/3] doc: usage: convert autoboot README to rST","References":"<20260415-ui-cosmetics-v3-0-aa8308a47e33@postmarketos.org>\n <20260415-ui-cosmetics-v3-3-aa8308a47e33@postmarketos.org>\n <61DCA2CF-A66E-47C5-8921-9747FAC8C75B@gmx.de>\n \n <2D15A5D4-D938-4DDD-801A-84F7B0230E55@gmx.de>","In-Reply-To":"<2D15A5D4-D938-4DDD-801A-84F7B0230E55@gmx.de>","Message-ID":"","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Content-Type":"text/plain; charset=utf-8; format=flowed","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"}}]