xref: /linux/Documentation/core-api/kho/bindings/kho.yaml (revision 00c010e130e58301db2ea0cec1eadc931e1cb8cf)
1*3498209fSAlexander Graf# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*3498209fSAlexander Graf%YAML 1.2
3*3498209fSAlexander Graf---
4*3498209fSAlexander Graftitle: Kexec HandOver (KHO) root tree
5*3498209fSAlexander Graf
6*3498209fSAlexander Grafmaintainers:
7*3498209fSAlexander Graf  - Mike Rapoport <rppt@kernel.org>
8*3498209fSAlexander Graf  - Changyuan Lyu <changyuanl@google.com>
9*3498209fSAlexander Graf
10*3498209fSAlexander Grafdescription: |
11*3498209fSAlexander Graf  System memory preserved by KHO across kexec.
12*3498209fSAlexander Graf
13*3498209fSAlexander Grafproperties:
14*3498209fSAlexander Graf  compatible:
15*3498209fSAlexander Graf    enum:
16*3498209fSAlexander Graf      - kho-v1
17*3498209fSAlexander Graf
18*3498209fSAlexander Graf  preserved-memory-map:
19*3498209fSAlexander Graf    description: |
20*3498209fSAlexander Graf      physical address (u64) of an in-memory structure describing all preserved
21*3498209fSAlexander Graf      folios and memory ranges.
22*3498209fSAlexander Graf
23*3498209fSAlexander GrafpatternProperties:
24*3498209fSAlexander Graf  "$[0-9a-f_]+^":
25*3498209fSAlexander Graf    $ref: sub-fdt.yaml#
26*3498209fSAlexander Graf    description: physical address of a KHO user's own FDT.
27*3498209fSAlexander Graf
28*3498209fSAlexander Grafrequired:
29*3498209fSAlexander Graf  - compatible
30*3498209fSAlexander Graf  - preserved-memory-map
31*3498209fSAlexander Graf
32*3498209fSAlexander GrafadditionalProperties: false
33*3498209fSAlexander Graf
34*3498209fSAlexander Grafexamples:
35*3498209fSAlexander Graf  - |
36*3498209fSAlexander Graf    kho {
37*3498209fSAlexander Graf        compatible = "kho-v1";
38*3498209fSAlexander Graf        preserved-memory-map = <0xf0be16 0x1000000>;
39*3498209fSAlexander Graf
40*3498209fSAlexander Graf        memblock {
41*3498209fSAlexander Graf                fdt = <0x80cc16 0x1000000>;
42*3498209fSAlexander Graf        };
43*3498209fSAlexander Graf    };
44