* [PATCH RESEND] efi_stub: update documentation on dtb= parameter
@ 2018-09-06 18:29 Grant Likely
2018-09-07 10:43 ` Ard Biesheuvel
2018-09-09 20:47 ` Jonathan Corbet
0 siblings, 2 replies; 3+ messages in thread
From: Grant Likely @ 2018-09-06 18:29 UTC (permalink / raw)
To: linux-efi, linux-kernel, linux-arm-kernel
Cc: olof, scott.branden, catalin.marinas, will.deacon, arnd,
leif.lindholm, agraf, nd, Grant Likely, Ard Biesheuvel,
Jonathan Corbet
The dtb= parameter is no longer the primary mechanism for providing a
devicetree to the kernel. Now either firmware or the boot selector (ex.
Grub) should provide the devicetree and dtb= should only be used for
debug or when using firmware that doesn't understand DT.
Update the EFI stub documentation to reflect the current usage.
Signed-off-by: Grant Likely <grant.likely@arm.com>
Reviewed-by: Alexander Graf <agraf@suse.de>
Acked-by: Leif Lindholm <leif.lindholm@linaro.org>
Acked-by: Olof Johansson <olof@lixom.net>
Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Cc: Jonathan Corbet <corbet@lwn.net>
---
Resending because original post included Arm corporate disclaimer.
Documentation/efi-stub.txt | 17 ++++++++++++++---
1 file changed, 14 insertions(+), 3 deletions(-)
diff --git a/Documentation/efi-stub.txt b/Documentation/efi-stub.txt
index 41df801f9a50..833edb0d0bc4 100644
--- a/Documentation/efi-stub.txt
+++ b/Documentation/efi-stub.txt
@@ -83,7 +83,18 @@ is passed to bzImage.efi.
The "dtb=" option
-----------------
-For the ARM and arm64 architectures, we also need to be able to provide a
-device tree to the kernel. This is done with the "dtb=" command line option,
-and is processed in the same manner as the "initrd=" option that is
+For the ARM and arm64 architectures, a device tree must be provided to
+the kernel. Normally firmware shall supply the device tree via the
+EFI CONFIGURATION TABLE. However, the "dtb=" command line option can
+be used to override the firmware supplied device tree, or to supply
+one when firmware is unable to.
+
+Please note: Firmware adds runtime configuration information to the
+device tree before booting the kernel. If dtb= is used to override
+the device tree, then any runtime data provided by firmware will be
+lost. The dtb= option should only be used either as a debug tool, or
+as a last resort when a device tree is not provided in the EFI
+CONFIGURATION TABLE.
+
+"dtb=" is processed in the same manner as the "initrd=" option that is
described above.
--
2.11.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH RESEND] efi_stub: update documentation on dtb= parameter
2018-09-06 18:29 [PATCH RESEND] efi_stub: update documentation on dtb= parameter Grant Likely
@ 2018-09-07 10:43 ` Ard Biesheuvel
2018-09-09 20:47 ` Jonathan Corbet
1 sibling, 0 replies; 3+ messages in thread
From: Ard Biesheuvel @ 2018-09-07 10:43 UTC (permalink / raw)
To: Grant Likely
Cc: linux-efi, Linux Kernel Mailing List, linux-arm-kernel,
Olof Johansson, Scott Branden, Catalin Marinas, Will Deacon,
Arnd Bergmann, Leif Lindholm, Alexander Graf, nd,
Jonathan Corbet
On 6 September 2018 at 20:29, Grant Likely <grant.likely@arm.com> wrote:
> The dtb= parameter is no longer the primary mechanism for providing a
> devicetree to the kernel. Now either firmware or the boot selector (ex.
> Grub) should provide the devicetree and dtb= should only be used for
> debug or when using firmware that doesn't understand DT.
> Update the EFI stub documentation to reflect the current usage.
>
> Signed-off-by: Grant Likely <grant.likely@arm.com>
> Reviewed-by: Alexander Graf <agraf@suse.de>
> Acked-by: Leif Lindholm <leif.lindholm@linaro.org>
> Acked-by: Olof Johansson <olof@lixom.net>
> Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
Acked-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> ---
>
> Resending because original post included Arm corporate disclaimer.
>
> Documentation/efi-stub.txt | 17 ++++++++++++++---
> 1 file changed, 14 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/efi-stub.txt b/Documentation/efi-stub.txt
> index 41df801f9a50..833edb0d0bc4 100644
> --- a/Documentation/efi-stub.txt
> +++ b/Documentation/efi-stub.txt
> @@ -83,7 +83,18 @@ is passed to bzImage.efi.
> The "dtb=" option
> -----------------
>
> -For the ARM and arm64 architectures, we also need to be able to provide a
> -device tree to the kernel. This is done with the "dtb=" command line option,
> -and is processed in the same manner as the "initrd=" option that is
> +For the ARM and arm64 architectures, a device tree must be provided to
> +the kernel. Normally firmware shall supply the device tree via the
> +EFI CONFIGURATION TABLE. However, the "dtb=" command line option can
> +be used to override the firmware supplied device tree, or to supply
> +one when firmware is unable to.
> +
> +Please note: Firmware adds runtime configuration information to the
> +device tree before booting the kernel. If dtb= is used to override
> +the device tree, then any runtime data provided by firmware will be
> +lost. The dtb= option should only be used either as a debug tool, or
> +as a last resort when a device tree is not provided in the EFI
> +CONFIGURATION TABLE.
> +
> +"dtb=" is processed in the same manner as the "initrd=" option that is
> described above.
> --
> 2.11.0
>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH RESEND] efi_stub: update documentation on dtb= parameter
2018-09-06 18:29 [PATCH RESEND] efi_stub: update documentation on dtb= parameter Grant Likely
2018-09-07 10:43 ` Ard Biesheuvel
@ 2018-09-09 20:47 ` Jonathan Corbet
1 sibling, 0 replies; 3+ messages in thread
From: Jonathan Corbet @ 2018-09-09 20:47 UTC (permalink / raw)
To: Grant Likely
Cc: linux-efi, linux-kernel, linux-arm-kernel, olof, scott.branden,
catalin.marinas, will.deacon, arnd, leif.lindholm, agraf, nd,
Ard Biesheuvel
On Thu, 6 Sep 2018 19:29:27 +0100
Grant Likely <grant.likely@arm.com> wrote:
> The dtb= parameter is no longer the primary mechanism for providing a
> devicetree to the kernel. Now either firmware or the boot selector (ex.
> Grub) should provide the devicetree and dtb= should only be used for
> debug or when using firmware that doesn't understand DT.
> Update the EFI stub documentation to reflect the current usage.
>
> Signed-off-by: Grant Likely <grant.likely@arm.com>
> Reviewed-by: Alexander Graf <agraf@suse.de>
> Acked-by: Leif Lindholm <leif.lindholm@linaro.org>
> Acked-by: Olof Johansson <olof@lixom.net>
> Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Applied, thanks.
jon
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2018-09-09 20:47 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-09-06 18:29 [PATCH RESEND] efi_stub: update documentation on dtb= parameter Grant Likely
2018-09-07 10:43 ` Ard Biesheuvel
2018-09-09 20:47 ` Jonathan Corbet
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).