From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 66BA6C433F5 for ; Fri, 21 Jan 2022 15:09:01 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id E272A820AC; Fri, 21 Jan 2022 16:08:58 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=konsulko.com header.i=@konsulko.com header.b="mta2ASvC"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 5DE9A811E0; Fri, 21 Jan 2022 16:08:57 +0100 (CET) Received: from mail-qv1-xf33.google.com (mail-qv1-xf33.google.com [IPv6:2607:f8b0:4864:20::f33]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 55D328214F for ; Fri, 21 Jan 2022 16:08:54 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=trini@konsulko.com Received: by mail-qv1-xf33.google.com with SMTP id kl12so10654786qvb.5 for ; Fri, 21 Jan 2022 07:08:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=konsulko.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=vkYgjIHAbbhmh8LKsTFgOM1j4Rw3e2cEmfvqRjCUPGs=; b=mta2ASvCzGn4DTRstGdn86HyqHKAmBs0dDOgg6hgbb27gu/fBiX9wWxnyE5AOi1/yp hnsbWWwJzf5qo/IYtQ0aUkYKiRuLpjqDZhrH7GIqcr8+r1TPKOMwBL+8ZaAXUsHWSnUA 5/qaNpA6eBWcn4tA1Kgccl/x7101vrhVOPoGM= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=vkYgjIHAbbhmh8LKsTFgOM1j4Rw3e2cEmfvqRjCUPGs=; b=K7nIKBxY9K2Cg2SEkOOaPXsnBMz30sgOj6StSdVriFY76KaW354zwJZRICdIKNDRdB 2DJR8bFt0jjOdOTA9g6rkanFV/O1kdVYxXDbd437Thw9f6ENmBOrh3ahNfZy6hb7lp4+ C93lY7qh5h34RnEu4DqTZuVIA566fZgC23OqnvL8B5L1TPkeu/KuICHNI0o9TPOY5QLm nLk+pMsXDGwdnRzMYh5scIfnVLiydZfJNqQ07DcirsjsdOL8ZO5Ooo//3Pkf5jN/P5Q5 +Dmrjr2LATqaGbIGV93sl6Bz8GFwrQALsvVt61UuSi5YmQVMJk6Y6ejT3TwyinLulI8R QD3w== X-Gm-Message-State: AOAM5329mgFDi6AujMiA/n57mgQS6eobUhRzALDj99lAapQ4ufZdQMyw +Fyar8Pszf8kt8IX/0WoxlIMzg== X-Google-Smtp-Source: ABdhPJyrg7AQMABOHmHxYT63BR8mogDbUXh3ycjFgRiAiU9zP9kUlZEVAH0f1ApjEJYa/kiPho8lLQ== X-Received: by 2002:a05:6214:2684:: with SMTP id gm4mr3968170qvb.105.1642777733055; Fri, 21 Jan 2022 07:08:53 -0800 (PST) Received: from bill-the-cat (2603-6081-7b01-cbda-2ef0-5dff-fedb-a8ba.res6.spectrum.com. [2603:6081:7b01:cbda:2ef0:5dff:fedb:a8ba]) by smtp.gmail.com with ESMTPSA id u5sm3249141qtw.84.2022.01.21.07.08.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 21 Jan 2022 07:08:52 -0800 (PST) Date: Fri, 21 Jan 2022 10:08:50 -0500 From: Tom Rini To: Heinrich Schuchardt Cc: Simon Glass , Ilias Apalodimas , Daniel Schwierzeck , Dennis Gilmore , Steffen Jaeckel , Lukas Auer , Michal Simek , U-Boot Mailing List Subject: Re: [PATCH v3 30/31] bootstd: doc: Add documentation Message-ID: <20220121150850.GT7004@bill-the-cat> References: <20220119014315.1938157-1-sjg@chromium.org> <20220119014315.1938157-20-sjg@chromium.org> <28d88952-e1aa-46cd-fd60-ac52cd2ab43b@canonical.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="N1feavoG/SlNLCrA" Content-Disposition: inline In-Reply-To: <28d88952-e1aa-46cd-fd60-ac52cd2ab43b@canonical.com> X-Clacks-Overhead: GNU Terry Pratchett X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.5 at phobos.denx.de X-Virus-Status: Clean --N1feavoG/SlNLCrA Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Jan 19, 2022 at 12:39:03PM +0100, Heinrich Schuchardt wrote: > On 1/19/22 02:43, Simon Glass wrote: > > Add documentation for this feature, including the commands and full > > devicetree bindings. > >=20 > > Signed-off-by: Simon Glass > > --- > >=20 > > Changes in v3: > > - Update docs for "bootmeths" and "boot_targets" env vars > >=20 > > MAINTAINERS | 4 + > > doc/develop/bootstd.rst | 638 ++++++++++++++++++++++++++ > > doc/develop/distro.rst | 3 + > > doc/develop/index.rst | 1 + > > doc/device-tree-bindings/bootdev.txt | 18 + > > doc/device-tree-bindings/bootmeth.txt | 31 ++ > > doc/device-tree-bindings/bootstd.txt | 8 + > > doc/usage/bootdev.rst | 135 ++++++ > > doc/usage/bootflow.rst | 427 +++++++++++++++++ > > doc/usage/bootmeth.rst | 108 +++++ > > doc/usage/index.rst | 3 + > > 11 files changed, 1376 insertions(+) > > create mode 100644 doc/develop/bootstd.rst > > create mode 100644 doc/device-tree-bindings/bootmeth.txt > > create mode 100644 doc/usage/bootdev.rst > > create mode 100644 doc/usage/bootflow.rst > > create mode 100644 doc/usage/bootmeth.rst > >=20 > > diff --git a/MAINTAINERS b/MAINTAINERS > > index 8ad70d3d968..c2af8ada3c9 100644 > > --- a/MAINTAINERS > > +++ b/MAINTAINERS > > @@ -669,6 +669,10 @@ F: boot/bootmeth*.c > > F: boot/bootstd.c > > F: cmd/bootdev.c > > F: cmd/bootflow.c > > +F: doc/develop/bootstd.rst > > +F: doc/usage/bootdev.rst > > +F: doc/usage/bootflow.rst > > +F: doc/usage/bootmeth.rst > > F: drivers/mmc/mmc_bootdev.c > > F: include/bootdev.h > > F: include/bootflow.h > > diff --git a/doc/develop/bootstd.rst b/doc/develop/bootstd.rst > > new file mode 100644 > > index 00000000000..1b65a806efb > > --- /dev/null > > +++ b/doc/develop/bootstd.rst > > @@ -0,0 +1,638 @@ > > +.. SPDX-License-Identifier: GPL-2.0+: > > + > > +U-Boot Standard Boot > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > + > > +Introduction > > +------------ > > + > > +Standard boot provides a built-in way for U-Boot to automatically boot > > +an Operating System without custom scripting and other customisation. = It > > +introduces the following concepts: > > + > > + - bootdev - a device which can hold or access a distro (e.g. MMC, = Ethernet) > > + - bootmeth - a method to scan a bootdev to find bootflows (e.g. dis= tro boot) > > + - bootflow - a description of how to boot (provided by the distro) > > + > > +For Linux, the distro (Linux distribution, e.g. Debian, Fedora) is res= ponsible > > +for creating a bootflow for each kernel combination that it wants to o= ffer. >=20 > This gets it completely wrong. There is one standardized boot flow: UEFI. > All major distros support this. U-Boot has to offer UEFI booting out of t= he > box. I want to jump up and down and emphasize this part as well. While I believe our UEFI bootmgr is still missing the normal scan code, that's something that has been promised to be implemented. And that turns the bootcmd for platforms that just want to support modern off the shelf distros in to something fairly small. --=20 Tom --N1feavoG/SlNLCrA Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGzBAABCgAdFiEEGjx/cOCPqxcHgJu/FHw5/5Y0tywFAmHqzIIACgkQFHw5/5Y0 tywQBwv+J1ib5tgRf5Dpo4rgRaP92Y6cKykvc1BFWgJgIhnqQc1R1gNJkMUJjG4h IZvldVMfONAetaT41Bit4SDThkrLakwg7eWfSqFFDvgnnz1v5QFoZVnBmG5zJkEr ZWPNvyHGTJKzisxA89qdxZL2sLsaiQ1bPLFGxkiWVvAugiX+j/+/JQHqJPyyAI8A Rh8MEnkPCpl4o4L0a3s9YpyssyCTmfV5o3zvxpj5Ai/CJP4QCYdWjLKsWiFLJ5mY LUjrRMOO2RMsCXh153z2yl1FZT8TqtgMYpMykfdqlO9hAuY+zkTWEwoBrlwUwZQU yII38SsL+wJ8RZkuL+Ig5/N1DrCiNINDaK64xSEtXKMjp/dvCM6WBD2DUltIPT0k eN3XLOxadh8VDf2yEEwXAtd5n95H1ZmU/2OFyT4JHXBp6ML/xw6m4qyQozzFNWec pbmYpWyNoExH7ob3w0sDO1GmNcbFodOCzl403BE7t3L+y00X82ma2Us5E3Ler5z5 brknKk+I =3f+m -----END PGP SIGNATURE----- --N1feavoG/SlNLCrA--