From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 5CA4B1BAF5 for ; Tue, 18 Dec 2018 09:12:32 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Dec 2018 00:12:32 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,367,1539673200"; d="scan'208";a="102375089" Received: from dpdk-xiao-1.sh.intel.com ([10.67.111.145]) by orsmga008.jf.intel.com with ESMTP; 18 Dec 2018 00:12:30 -0800 From: Xiao Wang To: tiwei.bie@intel.com, maxime.coquelin@redhat.com Cc: alejandro.lucero@netronome.com, dev@dpdk.org, zhihong.wang@intel.com, xiaolong.ye@intel.com, Xiao Wang Date: Tue, 18 Dec 2018 16:02:07 +0800 Message-Id: <20181218080207.178666-11-xiao.w.wang@intel.com> X-Mailer: git-send-email 2.15.1 In-Reply-To: <20181218080207.178666-1-xiao.w.wang@intel.com> References: <20181214211612.167681-4-xiao.w.wang@intel.com> <20181218080207.178666-1-xiao.w.wang@intel.com> Subject: [dpdk-dev] [PATCH v5 10/10] doc: update ifc NIC document X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Dec 2018 08:12:32 -0000 Add the SW assisted VDPA live migration feature into NIC doc. Signed-off-by: Xiao Wang --- doc/guides/nics/ifc.rst | 12 +++++++++++- doc/guides/rel_notes/release_19_02.rst | 6 ++++++ 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/ifc.rst b/doc/guides/nics/ifc.rst index 48f9adf1d..bdf7b4e4a 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 e86ef9511..131216e19 100644 --- a/doc/guides/rel_notes/release_19_02.rst +++ b/doc/guides/rel_notes/release_19_02.rst @@ -60,6 +60,12 @@ 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. Removed Items ------------- -- 2.15.1