I/O memory isolation management endpoint

This endpoint is intended for managing the isolation of physical memory regions used by devices on a PCIe bus for DMA. (Isolation is provided by the IOMMU.)

Information about methods of the endpoint is provided in the table below.

Methods of the iommu.IOMMU endpoint (kl.core.IOMMU interface)

Method	Method purpose and parameters	Potential danger of the method
`Attach`	Purpose Attaches a device on a PCIe bus to the IOMMU domain associated with the calling process. Parameters [in] `bdf` – address of the device on the PCIe bus in BDF format. [out] `rc` – return code.	Attaches a device on a PCIe bus managed by another process to an IOMMU domain associated with the calling process, which leads to failure of the device. It is recommended to monitor the address of a device on a PCIe bus.
`Detach`	Purpose Detaches a device on a PCIe bus from the IOMMU domain associated with the calling process. Parameters [in] `bdf` – address of the device on the PCIe bus in BDF format. [out] `rc` – return code.	N/A

Method

Method purpose and parameters

Potential danger of the method

Attach

Purpose

Attaches a device on a PCIe bus to the IOMMU domain associated with the calling process.

Parameters

[in] bdf – address of the device on the PCIe bus in BDF format.
[out] rc – return code.

Attaches a device on a PCIe bus managed by another process to an IOMMU domain associated with the calling process, which leads to failure of the device.

It is recommended to monitor the address of a device on a PCIe bus.

Detach

Purpose

Detaches a device on a PCIe bus from the IOMMU domain associated with the calling process.

Parameters

[in] bdf – address of the device on the PCIe bus in BDF format.
[out] rc – return code.

N/A

Page top