Thread (3 messages) flat view 3 messages, 2 authors, 2021-09-03
STALE1804d

[PATCH dt-schema 2/2] schemas: chosen: Improve linux,elfcorehdr documentation

From: Geert Uytterhoeven <geert+renesas@glider.be>
Date: 2021-09-01 15:13:27
Subsystem: the rest · Maintainer: Linus Torvalds

Add an example for the "linux,elfcorehdr" property, and clarify the
length of its address and size.

Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
---
 schemas/chosen.yaml | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)
diff --git a/schemas/chosen.yaml b/schemas/chosen.yaml
index 78b87cb1b2b7fb87..d66d10ad3cad0654 100644
--- a/schemas/chosen.yaml
+++ b/schemas/chosen.yaml
@@ -77,11 +77,21 @@ properties:
   linux,elfcorehdr:
     $ref: types.yaml#/definitions/uint64-array
     maxItems: 2
-    description:
+    description: |
       This property holds the memory range, the address and the size, of the
       elf core header which mainly describes the panicked kernel\'s memory
       layout as PT_LOAD segments of elf format.
 
+      / {
+              chosen {
+                      linux,elfcorehdr = <0x9 0xfffff000 0x0 0x800>;
+              };
+      };
+
+      While this property does not represent a real hardware, the address
+      and the size are expressed in #address-cells and #size-cells,
+      respectively, of the root node.
+
   linux,usable-memory-range:
     $ref: types.yaml#/definitions/uint64-array
     maxItems: 2
-- 
2.25.1
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help