[PATCH v5] devicetree, xen: add xen, shared-memory binding

[PATCH v5] devicetree, xen: add xen, shared-memory binding

[Stefano Stabellini]

From: Stefano Stabellini <stefanos@xilinx.com>

Introduce a device tree binding for Xen reserved-memory regions. They
are used to share memory across VMs from the VM config files. (See
static_shm config option.)

Signed-off-by: Stefano Stabellini <stefanos@xilinx.com>
Cc: julien.grall@arm.com
Cc: devicetree@vger.kernel.org
Cc: robh+dt@kernel.org
Cc: mark.rutland@arm.com
Cc: xen-devel@lists.xen.org
---
Changes in v5:
-rename offset to xen,offset

Changes in v4:
- add offset property

Changes in v3:
- remove fallback version

Changes in v2:
- fix Author line
- add versioning
- xen,id instead of id
---
 .../bindings/reserved-memory/xen,shared-memory.txt | 24 ++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/reserved-memory/xen,shared-memory.txt

diff --git a/Documentation/devicetree/bindings/reserved-memory/xen,shared-memory.txt b/Documentation/devicetree/bindings/reserved-memory/xen,shared-memory.txt
new file mode 100644
index 0000000..d483a21
--- /dev/null
+++ b/Documentation/devicetree/bindings/reserved-memory/xen,shared-memory.txt
@@ -0,0 +1,24 @@
+* Xen hypervisor reserved-memory binding
+
+Expose one or more memory regions as reserved-memory to the guest
+virtual machine. Typically, a region is configured at VM creation time
+to be a shared memory area across multiple virtual machines for
+communication among them.
+
+For each of these pre-shared memory regions, a range is exposed under
+the /reserved-memory node as a child node. Each range sub-node is named
+xen-shmem@<address> and has the following properties:
+
+- compatible:
+	compatible = "xen,shared-memory-v1"
+
+- reg:
+	the base guest physical address and size of the shared memory region
+
+- xen,offset: (borrower VMs only)
+	64 bit integer offset within the owner virtual machine's shared
+	memory region used for the mapping in the borrower VM.
+
+- xen,id:
+	a string that identifies the shared memory region as specified in
+	the VM config file
-- 
1.9.1


_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel

Re: [PATCH v5] devicetree, xen: add xen, shared-memory binding

[Rob Herring]

On Mon, Dec 03, 2018 at 02:26:09PM -0800, Stefano Stabellini wrote:
> From: Stefano Stabellini <stefanos@xilinx.com>
> 
> Introduce a device tree binding for Xen reserved-memory regions. They
> are used to share memory across VMs from the VM config files. (See
> static_shm config option.)
> 
> Signed-off-by: Stefano Stabellini <stefanos@xilinx.com>
> Cc: julien.grall@arm.com
> Cc: devicetree@vger.kernel.org
> Cc: robh+dt@kernel.org
> Cc: mark.rutland@arm.com
> Cc: xen-devel@lists.xen.org
> ---
> Changes in v5:
> -rename offset to xen,offset
> 
> Changes in v4:
> - add offset property
> 
> Changes in v3:
> - remove fallback version
> 
> Changes in v2:
> - fix Author line
> - add versioning
> - xen,id instead of id
> ---
>  .../bindings/reserved-memory/xen,shared-memory.txt | 24 ++++++++++++++++++++++
>  1 file changed, 24 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/reserved-memory/xen,shared-memory.txt

Applied, thanks.

Rob

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel