From patchwork Mon Nov 22 08:49:48 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Ding, Xuan" X-Patchwork-Id: 104561 X-Patchwork-Delegate: maxime.coquelin@redhat.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id D32F8A0C45; Mon, 22 Nov 2021 10:04:49 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 91E21410E8; Mon, 22 Nov 2021 10:04:49 +0100 (CET) Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by mails.dpdk.org (Postfix) with ESMTP id CE4DA4014E for ; Mon, 22 Nov 2021 10:04:47 +0100 (CET) X-IronPort-AV: E=McAfee;i="6200,9189,10175"; a="234694546" X-IronPort-AV: E=Sophos;i="5.87,254,1631602800"; d="scan'208";a="234694546" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Nov 2021 01:04:46 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.87,254,1631602800"; d="scan'208";a="508873229" Received: from dpdk-xuanding-dev2.sh.intel.com ([10.67.119.250]) by orsmga008.jf.intel.com with ESMTP; 22 Nov 2021 01:04:44 -0800 From: Xuan Ding To: maxime.coquelin@redhat.com, chenbo.xia@intel.com Cc: dev@dpdk.org, jiayu.hu@intel.com, yinan.wang@intel.com, xingguang.he@intel.com, Xuan Ding Subject: [PATCH] doc: update recommended IOVA mode for async vhost Date: Mon, 22 Nov 2021 08:49:48 +0000 Message-Id: <20211122084948.39382-1-xuan.ding@intel.com> X-Mailer: git-send-email 2.17.1 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org DPDK 21.11 adds vfio support for DMA device in vhost. This patch updates recommended IOVA mode in async datapath. Signed-off-by: Xuan Ding Reviewed-by: Maxime Coquelin --- doc/guides/prog_guide/vhost_lib.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/guides/prog_guide/vhost_lib.rst b/doc/guides/prog_guide/vhost_lib.rst index 76f5d303c9..f72ce75909 100644 --- a/doc/guides/prog_guide/vhost_lib.rst +++ b/doc/guides/prog_guide/vhost_lib.rst @@ -442,3 +442,12 @@ Finally, a set of device ops is defined for device specific operations: * ``get_notify_area`` Called to get the notify area info of the queue. + +Recommended IOVA mode in async datapath +--------------------------------------- + +When DMA devices are bound to vfio driver, VA mode is recommended. +For PA mode, page by page mapping may exceed IOMMU's max capability, +better to use 1G guest hugepage. + +For uio driver, any vfio related error message can be ignored. \ No newline at end of file