Documentation/devicetree/bindings/iommu/xen,grant-dma.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/iommu/xen,grant-dma.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/iommu/xen,grant-dma.yaml
Extension
.yaml
Size
993 bytes
Lines
40
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iommu/xen,grant-dma.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Xen specific IOMMU for virtualized devices (e.g. virtio)

maintainers:
  - Stefano Stabellini <sstabellini@kernel.org>

description:
  The Xen IOMMU represents the Xen grant table interface. Grant mappings
  are to be used with devices connected to the Xen IOMMU using the "iommus"
  property, which also specifies the ID of the backend domain.
  The binding is required to restrict memory access using Xen grant mappings.

properties:
  compatible:
    const: xen,grant-dma

  '#iommu-cells':
    const: 1
    description:
      The single cell is the domid (domain ID) of the domain where the backend
      is running.

required:
  - compatible
  - "#iommu-cells"

additionalProperties: false

examples:
  - |
    iommu {
        compatible = "xen,grant-dma";
        #iommu-cells = <1>;
    };

Annotation

Implementation Notes