tmakin/ack-tegra
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

ANDROID: KVM: arm64: Document ARM_SMCCC_KVM_FUNC_DEV_REQ_MMIO

Browse Source 
Add documentation for ARM_SMCCC_KVM_FUNC_DEV_REQ_MMIO HVC.

Bug: 357781595
Bug: 348382247
Change-Id: Ib5740b6b587ab282a3db4b00c95c5737edb207d4
Signed-off-by: Mostafa Saleh <smostafa@google.com>
This commit is contained in:
Mostafa Saleh
2024-07-08 21:06:31 +00:00
committed by Treehugger Robot
parent 774b9063c8
commit 0ef1cbfd4a
1 changed files with 45 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Documentation/virt/kvm/arm/hypercalls.rst
+45
View File
@@ -214,3 +214,48 @@ of processed granules * protection granule size).
If the number of processed granules returned is zero (R1), an error (R0) will be
set.
``ARM_SMCCC_KVM_FUNC_DEV_REQ_MMIO``
--------------------------------------
Verify a device MMIO region matches the host description in the firmware
tables for a physical device passthrough to a protected virtual machine.
Called per page as defined by ``ARM_SMCCC_KVM_FUNC_HYP_MEMINFO`` using the
IPA of the resource.
Must be called after one of the following for the same IPA, which indicates
that this IPA range is MMIO:
* ``ARM_SMCCC_KVM_FUNC_MMIO_RGUARD_MAP``
* ``ARM_SMCCC_KVM_FUNC_MMIO_RGUARD_UNMAP``
Returns a token that can be used to verify the IPA page, the VM
typically have access to a trusted description of the device containing
the tokens. Where it can compare both.
Must be called before any MMIO access for protected virtual machines.
Ideally from the protected vm firmware.
After this call succeeds, access to this IPA would be through stage-2 and won't
exit to the host.
+---------------------+-------------------------------------------------------------+
| Presence: | Optional. |
+---------------------+-------------------------------------------------------------+
| Calling convention: | HVC64 |
+---------------------+----------+--------------------------------------------------+
| Function ID: | (uint32) | 0xC6000003F |
+---------------------+----------+----+---------------------------------------------+
| Arguments: | (uint64) | R1 | Base IPA of MMIO region |
| +----------+----+---------------------------------------------+
| | (uint64) | R2 | Reserved / Must be zero |
| +----------+----+---------------------------------------------+
| | (uint64) | R3 | Reserved / Must be zero |
+---------------------+----------+----+---------------------------------------------+
| Return Values: | (int64) | R0 | ``SUCCESS (0)`` |
| | | +---------------------------------------------+
| | | | ``INVALID_PARAMETER (-3)`` |
| +----------+----+---------------------------------------------+
| | (uint64) | R1 | Token used to represent the page which |
| | | | can be used to verify it. |
+---------------------+----------+----+---------------------------------------------+