From: Mauro Carvalho Chehab <mchehab+huawei@kernel•org>
To: Rob Herring <robh@kernel•org>
Cc: devicetree@vger•kernel.org,
Thomas Bogendoerfer <tsbogend@alpha•franken.de>,
Yoshinori Sato <ysato@users•sourceforge.jp>,
Geert Uytterhoeven <geert+renesas@glider•be>,
Jonathan Corbet <corbet@lwn•net>,
linux-sh@vger•kernel.org, x86@kernel•org,
linux-doc@vger•kernel.org, linux-kernel@vger•kernel.org,
linux-mips@vger•kernel.org, linuxppc-dev@lists•ozlabs.org,
Rich Felker <dalias@libc•org>, Paul Mackerras <paulus@samba•org>,
"H. Peter Anvin" <hpa@zytor•com>, Borislav Petkov <bp@alien8•de>,
Thomas Gleixner <tglx@linutronix•de>,
Frank Rowand <frowand.list@gmail•com>,
Ingo Molnar <mingo@redhat•com>
Subject: Re: [PATCH 2/2] dt: Remove booting-without-of.rst
Date: Wed, 21 Oct 2020 08:45:18 +0200 [thread overview]
Message-ID: <20201021084518.1eab6481@coco.lan> (raw)
In-Reply-To: <20201008142420.2083861-2-robh@kernel.org>
Hi Rob,
Em Thu, 8 Oct 2020 09:24:20 -0500
Rob Herring <robh@kernel•org> escreveu:
> booting-without-of.rstt is an ancient document that first outlined
> Flattened DeviceTree on PowerPC initially. The DT world has evolved a
> lot in the 15 years since and booting-without-of.rst is pretty stale.
> The name of the document itself is confusing if you don't understand the
> evolution from real 'OpenFirmware'. Most of what booting-without-of.rst
> contains is now in the DT specification (which evolved out of the
> ePAPR). The few things that weren't documented in the DT specification
> are now.
>
> All that remains is the boot entry details, so let's move these to arch
> specific documents. The exception is arm which already has the same
> details documented.
Removing this document caused a warning at Documentation/arm/booting.rst:
$ ./scripts/documentation-file-ref-check
Documentation/arm/booting.rst: Documentation/devicetree/booting-without-of.rst
as it mentions that the DTB format is described on booting-without-of.rst:
4b. Setup the device tree
-------------------------
The boot loader must load a device tree image (dtb) into system ram
at a 64bit aligned address and initialize it with the boot data. The
dtb format is documented in Documentation/devicetree/booting-without-of.rst.
The kernel will look for the dtb magic value of 0xd00dfeed at the dtb
physical address to determine if a dtb has been passed instead of a
tagged list.
So, I guess that such part of the document needs to be moved to booting.rst.
Thanks,
Mauro
next prev parent reply other threads:[~2020-10-21 6:47 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-10-08 14:24 [PATCH 1/2] dt-bindings: powerpc: Add a schema for the 'sleep' property Rob Herring
2020-10-08 14:24 ` [PATCH 2/2] dt: Remove booting-without-of.rst Rob Herring
2020-10-08 15:03 ` Borislav Petkov
2020-10-09 3:51 ` Michael Ellerman
2020-10-21 6:45 ` Mauro Carvalho Chehab [this message]
2021-01-17 16:10 ` [PATCH 1/2] dt-bindings: powerpc: Add a schema for the 'sleep' property Johan Jonker
2021-01-20 1:44 ` Rob Herring
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20201021084518.1eab6481@coco.lan \
--to=mchehab+huawei@kernel$(echo .)org \
--cc=bp@alien8$(echo .)de \
--cc=corbet@lwn$(echo .)net \
--cc=dalias@libc$(echo .)org \
--cc=devicetree@vger$(echo .)kernel.org \
--cc=frowand.list@gmail$(echo .)com \
--cc=geert+renesas@glider$(echo .)be \
--cc=hpa@zytor$(echo .)com \
--cc=linux-doc@vger$(echo .)kernel.org \
--cc=linux-kernel@vger$(echo .)kernel.org \
--cc=linux-mips@vger$(echo .)kernel.org \
--cc=linux-sh@vger$(echo .)kernel.org \
--cc=linuxppc-dev@lists$(echo .)ozlabs.org \
--cc=mingo@redhat$(echo .)com \
--cc=paulus@samba$(echo .)org \
--cc=robh@kernel$(echo .)org \
--cc=tglx@linutronix$(echo .)de \
--cc=tsbogend@alpha$(echo .)franken.de \
--cc=x86@kernel$(echo .)org \
--cc=ysato@users$(echo .)sourceforge.jp \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox