From: Xiao Wang Date: Tue, 18 Dec 2018 08:02:07 +0000 (+0800) Subject: doc: update ifc NIC document X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=f42cc9a81b52ab1de4628e2bd4f87fc3fa1ef6e2;p=dpdk.git doc: update ifc NIC document Add the SW assisted VDPA live migration feature into NIC doc. Signed-off-by: Xiao Wang Reviewed-by: Maxime Coquelin --- diff --git a/doc/guides/nics/ifc.rst b/doc/guides/nics/ifc.rst index 48f9adf1d2..bdf7b4e4a4 100644 --- a/doc/guides/nics/ifc.rst +++ b/doc/guides/nics/ifc.rst @@ -31,7 +31,8 @@ IFCVF's vendor ID and device ID are same as that of virtio net pci device, with its specific subsystem vendor ID and device ID. To let the device be probed by IFCVF driver, adding "vdpa=1" parameter helps to specify that this device is to be used in vDPA mode, rather than polling mode, virtio pmd will -skip when it detects this message. +skip when it detects this message. If no this parameter specified, device +will not be used as a vDPA device, and it will be driven by virtio pmd. Different VF devices serve different virtio frontends which are in different VMs, so each VF needs to have its own DMA address translation service. During @@ -39,6 +40,14 @@ the driver probe a new container is created for this device, with this container vDPA driver can program DMA remapping table with the VM's memory region information. +The device argument "sw-live-migration=1" will configure the driver into SW +assisted live migration mode. In this mode, the driver will set up a SW relay +thread when LM happens, this thread will help device to log dirty pages. Thus +this mode does not require HW to implement a dirty page logging function block, +but will consume some percentage of CPU resource depending on the network +throughput. If no this parameter specified, driver will rely on device's logging +capability. + Key IFCVF vDPA driver ops ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -70,6 +79,7 @@ Features Features of the IFCVF driver are: - Compatibility with virtio 0.95 and 1.0. +- SW assisted vDPA live migration. Prerequisites diff --git a/doc/guides/rel_notes/release_19_02.rst b/doc/guides/rel_notes/release_19_02.rst index 0b248d55d3..a8c03d367e 100644 --- a/doc/guides/rel_notes/release_19_02.rst +++ b/doc/guides/rel_notes/release_19_02.rst @@ -80,6 +80,13 @@ New Features * Added the handler to get firmware version string. * Added support for multicast filtering. +* **Added support for SW-assisted VDPA live migration.** + + This SW-assisted VDPA live migration facility helps VDPA devices without + logging capability to perform live migration, a mediated SW relay can help + devices to track dirty pages caused by DMA. IFC driver has enabled this + SW-assisted live migration mode. + * **Added a compression performance test tool.** Added a new performance test tool to test the compressdev PMD. The tool tests