[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [PATCH 8/8] admin: Add requirements of write reporting commands
Add device and driver requirements for the write reporting commands. Signed-off-by: Parav Pandit <parav@nvidia.com> --- admin-cmds-device-migration.tex | 36 +++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/admin-cmds-device-migration.tex b/admin-cmds-device-migration.tex index 49835eb..09e772a 100644 --- a/admin-cmds-device-migration.tex +++ b/admin-cmds-device-migration.tex @@ -514,6 +514,34 @@ \subsubsection{Device Migration}\label{sec:Basic Facilities of a Virtio Device / and on receiving the reads, the device MUST function same regardless of the device mode is \field{Active} or \field{Stop} or \field{Freeze}. +A device MUST either support all of, or none of +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORD_CAP_QUERY, +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_START, +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_STOP and +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_READ commands. + +If the device supports VIRTIO_ADMIN_CMD_DEV_WRITE_RECORD_CAP_QUERY +command, the device MUST set minimum one bit in the +\field{supported_iova_page_size_bitmap} and set non zero value in the +\field{supported_iova_ranges}. + +The device MUST fail the VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_READ and +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_STOP commands +if the write recording is not started by the driver. + +The device MUST fail VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_READ command +if the write recording is not started. + +For the SR-IOV group type, for the VF member device, VF function level +reset (FLR) MUST NOT stop write recording on the VF device and it MUST NOT +clear any write records already gathered by the owner device. + +The device MUST clear the write records which are returned in the +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_READ result. After command completion +of VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_READ if new write record is created +for the same IOVA range, the device MUST report such a write record as +new entry. + \drivernormative{\paragraph}{Device Migration}{Basic Facilities of a Virtio Device / Device groups / Group administration commands / Device Migration} The driver SHOULD read the complete device context using one or multiple @@ -536,3 +564,11 @@ \subsubsection{Device Migration}\label{sec:Basic Facilities of a Virtio Device / For the SR-IOV group type, the driver MUST NOT write into the VIRTIO_PCI_CAP_PCI_CFG capability area when the device mode is set to \field{Freeze}. + +The driver MUST NOT invoke VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_START +for overlapping IOVA ranges, each IOVA range supplied in the command or +across multiple commands MUST be supplying unique ranges. + +If the write recording is started by the driver using +VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_START commands, the driver MUST explicitly +stop the wrie recording using VIRTIO_ADMIN_CMD_DEV_WRITE_RECORDS_STOP command. -- 2.34.1
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]