Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1677237 > unrolled thread

[PATCH v3] of: document /sys/firmware/fdt

Started byfrowand.list@gmail.com
First post2017-06-29 00:30 +0200
Last post2017-06-30 16:20 +0200
Articles 2 — 2 participants

Back to article view | Back to linux.kernel


Contents

  [PATCH v3] of: document /sys/firmware/fdt frowand.list@gmail.com - 2017-06-29 00:30 +0200
    Re: [PATCH v3] of: document /sys/firmware/fdt Rob Herring <robh+dt@kernel.org> - 2017-06-30 16:20 +0200

#1677237 — [PATCH v3] of: document /sys/firmware/fdt

Fromfrowand.list@gmail.com
Date2017-06-29 00:30 +0200
Subject[PATCH v3] of: document /sys/firmware/fdt
Message-ID<tXtDc-13b-15@gated-at.bofh.it>
From: Frank Rowand <frank.rowand@sony.com>

Add ABI documentation for /sys/firmware/fdt

Update contact email for /sys/firmware/devicetree/* and add mail list

Signed-off-by: Frank Rowand <frank.rowand@sony.com>
---

changes from v2:
  - ignore v2, v3 is based on v1

changes from v1:
  - updated Grant's email address
  - updated Frank's email address

 Documentation/ABI/testing/sysfs-firmware-ofw | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/Documentation/ABI/testing/sysfs-firmware-ofw b/Documentation/ABI/testing/sysfs-firmware-ofw
index f562b188e71d..edcab3ccfcc0 100644
--- a/Documentation/ABI/testing/sysfs-firmware-ofw
+++ b/Documentation/ABI/testing/sysfs-firmware-ofw
@@ -1,6 +1,6 @@
 What:		/sys/firmware/devicetree/*
 Date:		November 2013
-Contact:	Grant Likely <grant.likely@linaro.org>
+Contact:	Grant Likely <grant.likely@arm.com>, devicetree@vger.kernel.org
 Description:
 		When using OpenFirmware or a Flattened Device Tree to enumerate
 		hardware, the device tree structure will be exposed in this
@@ -26,3 +26,27 @@ Description:
 		name plus address). Properties are represented as files
 		in the directory. The contents of each file is the exact
 		binary data from the device tree.
+
+What:		/sys/firmware/fdt
+Date:		February 2015
+KernelVersion:	3.19
+Contact:	Frank Rowand <frowand.list@gmail.com>, devicetree@vger.kernel.org
+Description:
+		Exports the FDT blob that was passed to the kernel by
+		the bootloader. This allows userland applications such
+		as kexec to access the raw binary. This blob is also
+		useful when debugging since it contains any changes
+		made to the blob by the bootloader.
+
+		The fact that this node does not reside under
+		/sys/firmware/device-tree is deliberate: FDT is also used
+		on arm64 UEFI/ACPI systems to communicate just the UEFI
+		and ACPI entry points, but the FDT is never unflattened
+		and used to configure the system.
+
+		A CRC32 checksum is calculated over the entire FDT
+		blob, and verified at late_initcall time. The sysfs
+		entry is instantiated only if the checksum is valid,
+		i.e., if the FDT blob has not been modified in the mean
+		time. Otherwise, a warning is printed.
+Users:		kexec, debugging
-- 
Frank Rowand <frank.rowand@sony.com>

[toc] | [next] | [standalone]


#1678863

FromRob Herring <robh+dt@kernel.org>
Date2017-06-30 16:20 +0200
Message-ID<tY4W5-6wZ-15@gated-at.bofh.it>
In reply to#1677237
On Wed, Jun 28, 2017 at 5:21 PM,  <frowand.list@gmail.com> wrote:
> From: Frank Rowand <frank.rowand@sony.com>
>
> Add ABI documentation for /sys/firmware/fdt
>
> Update contact email for /sys/firmware/devicetree/* and add mail list
>
> Signed-off-by: Frank Rowand <frank.rowand@sony.com>
> ---

Applied.

Rob

[toc] | [prev] | [standalone]


Back to top | Article view | linux.kernel


csiph-web