From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 13BD0A0545; Thu, 23 Jun 2022 05:09:46 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A7D7640A82; Thu, 23 Jun 2022 05:09:45 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by mails.dpdk.org (Postfix) with ESMTP id 350FE4069D for ; Thu, 23 Jun 2022 05:09:44 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1655953784; x=1687489784; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=SJ7dAflROiptah/k6psA5O/bVLkQwp7x2PcgJxj9c/A=; b=HHxNRZajlaRqKnPMAqlXs3lRNHo2R6pTbGn7aiSXFh/wPQobMIazsHaF NnWjrLagDlALS+f1KLIhr9Qa9O8JJorVDJJmWWcVzGw6NRp5XIVS6jopU 7BMWrtiPoc0Y5vlT7T+yEtuy7s1C7vSfixmlCynSMO0EJWIM+r+Ndl3I+ Z/ResFeSLB0WDa/TlgW20uv6bdkZ0boVVWSsr5ANcYX47fcvE5hjFxpRk Glv4Iqa5nyWvY9W5OC6Y7ZEHgGoZ91bYrJ/3EtyJ1od2pw8edmesgqJp3 0Kl77TgHF25lFm+wISb2a7YPDE35jmX+Y7VzMHWoAw8yG5iYVpq0Ge3fe g==; X-IronPort-AV: E=McAfee;i="6400,9594,10386"; a="280657315" X-IronPort-AV: E=Sophos;i="5.92,215,1650956400"; d="scan'208";a="280657315" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Jun 2022 20:09:28 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,215,1650956400"; d="scan'208";a="914994901" Received: from orsmsx605.amr.corp.intel.com ([10.22.229.18]) by fmsmga005.fm.intel.com with ESMTP; 22 Jun 2022 20:09:28 -0700 Received: from orsmsx608.amr.corp.intel.com (10.22.229.21) by ORSMSX605.amr.corp.intel.com (10.22.229.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27; Wed, 22 Jun 2022 20:09:28 -0700 Received: from orsmsx612.amr.corp.intel.com (10.22.229.25) by ORSMSX608.amr.corp.intel.com (10.22.229.21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27; Wed, 22 Jun 2022 20:09:27 -0700 Received: from ORSEDG601.ED.cps.intel.com (10.7.248.6) by orsmsx612.amr.corp.intel.com (10.22.229.25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27 via Frontend Transport; Wed, 22 Jun 2022 20:09:27 -0700 Received: from NAM10-MW2-obe.outbound.protection.outlook.com (104.47.55.104) by edgegateway.intel.com (134.134.137.102) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.27; Wed, 22 Jun 2022 20:09:27 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=AbKXHW+1jPu/HbNsFOdRDvYCjAOd8j7eoFTC5js2jbmHNAGgJF3fFYlNuzCsMdzrlnh6Oc4A5jHHcxC97auhuNCHmV6PfOhiCmaOKdth7GUmKDhz/8zu1fqSeuhqrKq2LcuRBS2uKTrCukHM1kQx1F4R/ft/t0VqMRTEURH95qtmIP9pcsdy2KApbQC09xQkQWETuRkiEJmTOI6ryhjklYeZOpnjpDL50DRzJtQNee0pgkbASMYiIt48s41WnEFk3XtAVDDveYTtZMKxevsvzRpVukgyelBH0E3TzaRYDdgYR8e/mV2y+1366Zl2iTMZkiStHK1POp09zbFHnrK3XQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=AVn/gSmtRqbsX8klHYRJdJWvpBSJcENO9wRdKU6o5Ds=; b=XMfmE8lfqgNiCaJhoa8G18yBnsmkfTEN1KJLNRZRGTyZVmU5dbVWEjoA/KnkLPf2vIHebmUuVEK1A+dNczP57Xp2pzxGiXy/zh2jiGfCDegJeo7atLrwUSHcA367sh3tw+wQAwqjYIxHO9pt21XJ9zYPAMTALbg6devwuStmE7Nm3AEPQwVxOutpJH7zEfG5NoHSo7+m4d7fbObQFriyYVWRlg+vf3lH4caiMlHI3Gf0rODUj67DXw0ZM4cUMHbdvRznL/YNmndcsX4Ho6NJSBNyu34bnDJlJeIybeJ0Ch1YTABRihVr4msN5ZnHttpDLCuQB7+o+3YgD/oaG/5qpQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from SN6PR11MB3504.namprd11.prod.outlook.com (2603:10b6:805:d0::17) by SN6PR11MB3392.namprd11.prod.outlook.com (2603:10b6:805:c5::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.15; Thu, 23 Jun 2022 03:09:26 +0000 Received: from SN6PR11MB3504.namprd11.prod.outlook.com ([fe80::54a0:2dbc:18b7:2aa9]) by SN6PR11MB3504.namprd11.prod.outlook.com ([fe80::54a0:2dbc:18b7:2aa9%7]) with mapi id 15.20.5353.022; Thu, 23 Jun 2022 03:09:25 +0000 From: "Xia, Chenbo" To: "Ding, Xuan" , "maxime.coquelin@redhat.com" CC: "dev@dpdk.org" , "Hu, Jiayu" Subject: RE: [PATCH v2] doc: update async enqueue API usage Thread-Topic: [PATCH v2] doc: update async enqueue API usage Thread-Index: AQHYhUAVzmPsBL5JGU6zosDOW6ZPMq1cUqxQ Date: Thu, 23 Jun 2022 03:09:25 +0000 Message-ID: References: <20220617093413.94960-1-xuan.ding@intel.com> <20220621072131.14756-1-xuan.ding@intel.com> In-Reply-To: <20220621072131.14756-1-xuan.ding@intel.com> Accept-Language: en-US, zh-CN Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: d24f75b4-d970-48fc-9485-08da54c5c71d x-ms-traffictypediagnostic: SN6PR11MB3392:EE_ x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: BPKb3wiVpItAP3fq/kYWHPGwIfgzv7/V5vkpaiiOUnwyHV+aAmO1X7wnX4i1eeEU2eMWgAgvIXSbvisBmjRWZ6LWRpgyA+F5aOtQS+b7N1nLLdnqmbvAjc0wWRw/3SqN+mxUr9zGDJ7wGsC25BP+Aa63dYyGWKDbRB5FtpDHtMGhywP84ulvOxISXbFsLsdqfpPEvyfPCkj4XBtXmdE2YFEXEMcZ8SYOwQWfdFRAnxii/+46Nvgf/MG4l0F4QKdEnF3U/3tIERnV5IuWzEHIcQIULsa66dQERDFbOSURS3+bjtmE0575PenPSyz19CPu/aLsNh/Qaqa0Q42mHfQrqgtXptV4NkSyPyAwnjadpyZPc4fhBu5AbhKILkqf8XdPd/n5Qt1XgRiKPdGyuSWB/8lUAq4hzgqwTM9RmyoAEWFq1CpIzgBrEt+3U0VPsOzBrtJn8lsr/z3Vtc8jpz0YKdIUrknbpdjEoxi/OS86wJLxMwgG0k8DUeDRPRJzUPch5EUcUYblcB61M7uQA7k6Vl8XmIoSEQTIQs1yVOJnB4N5EVx3SRZa6KktGMy+8mkEAYzed3eLAQ1AUba4Da3QygRC5Iqmy4U4ngV5VQM1vbY0C86T1IFYrP8b2TxO4tX5QlM7QYVJCgXp5ocUnsRQ9z6D22wujEaObxHGNPUaPlEaJ+GNQDz5z7NKQDjcifz64F0Kjfln62vqqw1ILf3ukLTHQGpQIpv6WxirMTP2hdGba6Go8qwuBeolX4xL06gb9l2ear49DPvE7Ldax2ZAvA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SN6PR11MB3504.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230016)(346002)(376002)(136003)(39860400002)(366004)(396003)(53546011)(52536014)(478600001)(186003)(8936002)(7696005)(55016003)(6506007)(86362001)(107886003)(9686003)(5660300002)(26005)(33656002)(2906002)(82960400001)(83380400001)(15650500001)(316002)(4326008)(76116006)(64756008)(8676002)(66946007)(66476007)(41300700001)(66446008)(66556008)(122000001)(38070700005)(38100700002)(110136005)(54906003)(71200400001); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?pCfyN712XIP8MfyQjk3d0hnh1cpy2izJznURs5Liidk714WFNqhUUeadTmgJ?= =?us-ascii?Q?02sOGk3mc4VeqUegH2ggh7veTIUDyjV2E77aPQKwzcfaOsvUHoLClAwJec9b?= =?us-ascii?Q?+GMW7f0H3StP5xVY6mpiNe1OcIeJ70nACHmTmNrFqFCGN4BUyLfvRjEtcxqQ?= =?us-ascii?Q?TtWapD3ycPZjkCIoiiE0NBQmWisugv8YYHBdR5yqEE0CcWOXMCuSCEWfSAPO?= =?us-ascii?Q?OJL2muWhDloISUpyszebGs5VkJ/l0KQQwYonvZpzIugEE+Pt58KFE8vHA09s?= =?us-ascii?Q?Svl4rl/xg16RpqUkQzBEMuaF9OMnnpA9PtJp6+uMpIYDG3sNEEZS0Vv+9ycP?= =?us-ascii?Q?cjFx3yPZ0ekKTRZiLI7hciCpdBwePbPU+IKdnVZaB/4PDai6zvOy+vqZ6tRj?= =?us-ascii?Q?eTocVhAhekQS7/N4Prgkl0JxK3FyjYPAv2ZNdp2hXCs4w5PJRb1h45EzmSWT?= =?us-ascii?Q?YecbyzrIwUvUUQNsK4052NJEYEs+OUfrLobCbQSTSqu08YXlWOQf/91xU3TD?= =?us-ascii?Q?1cH7oZEsr2MQ1nl0pHnfajM94cQPCEY9hLcufMbRp3E3wrmM/TZTkqN38KHp?= =?us-ascii?Q?QKJLKKVlWwroPaFF/S9uzcIbiaoSsR65D7xXN1TXLgrrWhQpGnmXybx6QkH+?= =?us-ascii?Q?hs/eKzJni4YL7zT6cI/FRmmFMrDit4/4mY9SzSMgMHs1qQPnKYOErz6/J+zr?= =?us-ascii?Q?x0PDXT22xMdqzaI9aLOEOzP5dYtREj2Y+Btzx512f7cycJgPeQPvDXo3F/Tf?= =?us-ascii?Q?NpmRVNkkRhFXGoC+mMc4dAUIQVrcENnSGLPF3WM96dagm3/69ss7oQ+9B1+r?= =?us-ascii?Q?RpkTz30VX9eTzdniE9v/yjZ/L2o7+smxZEiHEyFKgdZbuPI3lzmCNKIcidrK?= =?us-ascii?Q?iPZfp6J42JoJlJVJUBn2eOw0lznqeVb/y9doIRj+9A2EXsSdBaGu3+hwdbvj?= =?us-ascii?Q?Dxc4PEOhT2K3nv7ll/Pr2+T7gzHBX9vWiWLmXpirvzSS0AKbh5Kg6/YMHj3w?= =?us-ascii?Q?xAJyVby3MFn9Z0TaALytv7IoMEwtZiZLW+PSrnn9mIILfT1hQ+4pmYPTVP+a?= =?us-ascii?Q?sCqRpBKPb38gjlMbKqJdUW+CrGllUhN4K5YoAqaGSYYvH4f8HJMpBiBaQJji?= =?us-ascii?Q?TtftKynSG6c5MB1JcLKRtmU6YC79rQH8NTbNgY2VcXbKX5F+iuCc3FOJqb4O?= =?us-ascii?Q?1XI3Jh8g+SWsqH4Q8Y04tozCrHO8n100539JEVScwsQ+xwKnpU0Ja3PBgHYW?= =?us-ascii?Q?ZpagfRtLpyE0OXKWzbXEa/V4yayYFsTSNGsPV5tsN68BR5S3ysRucCq38a8/?= =?us-ascii?Q?U1rACoIEN7jb30RbfvWGwqVQj9vff1Ulu9eLvmuHpN1WJlennNtrUFvuuNNl?= =?us-ascii?Q?2CgT5ZNGJx+gn6tfjUyCPaL0CJYmlN9a5vHjSodArc0kQwPUS7gKecH/lUP6?= =?us-ascii?Q?IgRwh8XsTYbuxVOoLUg6b3GbbtXFyelPueu6uNFOEuMvK45bgF8BLlIA0bhi?= =?us-ascii?Q?4QM46FWmx/gWXJWBb5SzZF+GzUtJCKQpxAwcO5mTzL4IWYcL+cVeAncLNZzN?= =?us-ascii?Q?dOpcWVQ7+Y0fccqgX6TPYxmgxjeuySlIkX8CmMmBgta8b5cLIidxYVGSd6mh?= =?us-ascii?Q?iV2BhKSgQs4B1aXwQ6MKHy2dPLrVnFfSbBjRmQrIEhk9oqL1VfPwJMZ9tj4A?= =?us-ascii?Q?FpXmfm1DvnuBhvwiindFYiMdGWDIyHcyq4j+sPAi5CAJTHBxffcKY6xHnf6w?= =?us-ascii?Q?jmECoi1IeQ=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SN6PR11MB3504.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: d24f75b4-d970-48fc-9485-08da54c5c71d X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Jun 2022 03:09:25.1616 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: BTik24NvlgBmRCdMmiZ/4AFk6WgSfh/O2MBeliBT75wJT6/VCKELtD1BG38ZBQ6q8llHSp2Jq5kPar+wcVeD7Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR11MB3392 X-OriginatorOrg: intel.com 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 > -----Original Message----- > From: Ding, Xuan > Sent: Tuesday, June 21, 2022 3:22 PM > To: maxime.coquelin@redhat.com; Xia, Chenbo > Cc: dev@dpdk.org; Hu, Jiayu ; Ding, Xuan > > Subject: [PATCH v2] doc: update async enqueue API usage >=20 > From: Xuan Ding >=20 > This patch updates the correct usage for async enqueue APIs. > The rte_vhost_poll_enqueue_completed() needs to be > called in time to notify the guest of completed packets and > avoid packet loss. >=20 > Signed-off-by: Xuan Ding > --- > v2: > * refine doc and commit log > --- > doc/guides/prog_guide/vhost_lib.rst | 8 ++++++++ > 1 file changed, 8 insertions(+) >=20 > diff --git a/doc/guides/prog_guide/vhost_lib.rst > b/doc/guides/prog_guide/vhost_lib.rst > index cd3f6caa9a..628db3fc38 100644 > --- a/doc/guides/prog_guide/vhost_lib.rst > +++ b/doc/guides/prog_guide/vhost_lib.rst > @@ -480,6 +480,14 @@ the same vring with their own DMA virtual channels. > Besides, the number > of DMA devices is limited. For the purpose of scaling, it's necessary to > support sharing DMA channels among vrings. >=20 > +* Async enqueue API usage > + > + In async enqueue path, rte_vhost_poll_enqueue_completed() needs to be > + called in time to notify the guest of DMA copy completed packets. > + Moreover, calling rte_vhost_submit_enqueue_burst() all the time but > + not poll completed will cause the DMA ring to be full, which will > + result in packet loss eventually. > + > Recommended IOVA mode in async datapath > --------------------------------------- >=20 > -- > 2.17.1 Reviewed-by: Chenbo Xia