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 B8E4AA0548; Wed, 15 Jun 2022 03:49:09 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A88AC4280E; Wed, 15 Jun 2022 03:49:09 +0200 (CEST) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by mails.dpdk.org (Postfix) with ESMTP id 6941E40220 for ; Wed, 15 Jun 2022 03:49:08 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1655257748; x=1686793748; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=jBoeMAXvqUyYX03+iwEdqTG5Npp/BtiA73NzbJ3br9Q=; b=DOP77xXAmOCkEfHJTxstS86Gr9DrW0ItxrVWeNPu5U1WL9i3Q6i4YkCT eXrlbsOr5L1dSF96j0lKep1LclUzCyKk/5tFEGwTsN+toUem1m66Wm7kA U3O2K/BgffW22jL8/aGyIWD6zEt7n4TabUCpeJsatfEM/VtIWqlz4i280 aLmSOF8QHkBfL//dkNe//vVJlYvMQLKuOBHgjOidtiTj7hhrTe3Z2idNN 6Tb02es8ZTijBpP0QFyEjTL781KEjwA7FGtqczsCCXxZWck13f+BJH9iN 1R/plHZ0/j2oDcs4dtSdfv25TlPiiGTxt1rGAjYwlMp0HYJPdk94tH2LX A==; X-IronPort-AV: E=McAfee;i="6400,9594,10378"; a="304223375" X-IronPort-AV: E=Sophos;i="5.91,300,1647327600"; d="scan'208";a="304223375" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 14 Jun 2022 18:49:07 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.91,300,1647327600"; d="scan'208";a="911336719" Received: from orsmsx606.amr.corp.intel.com ([10.22.229.19]) by fmsmga005.fm.intel.com with ESMTP; 14 Jun 2022 18:49:04 -0700 Received: from orsmsx602.amr.corp.intel.com (10.22.229.15) by ORSMSX606.amr.corp.intel.com (10.22.229.19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27; Tue, 14 Jun 2022 18:49:04 -0700 Received: from ORSEDG602.ED.cps.intel.com (10.7.248.7) by orsmsx602.amr.corp.intel.com (10.22.229.15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27 via Frontend Transport; Tue, 14 Jun 2022 18:49:04 -0700 Received: from NAM11-BN8-obe.outbound.protection.outlook.com (104.47.58.177) by edgegateway.intel.com (134.134.137.103) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.27; Tue, 14 Jun 2022 18:49:03 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EX8jIvcQuA+E9zkGoBKhaIDSmmCS14m3NME+b8Tva4R8GZSyHQJEOYHLHGFe8OYpv/T2uTg9+koLw1mq4jHqMJTMTfpxkGV0TgGPSb0w4CLmnOmt4GsATr8FLYQ4jepN/a3Nt5DVjSy4TIi07MhnGiq0JAJQEw8k16EL0FSaE9UsihKncTPxGIS5Eb+1cOEKaco6F1Y4W7YfP+JLbTBO/wZBYjawyL3hDP3Y7eXAcJach13v4ZSgNEDqCAfBAnCNeYFvLBrbckQWfKDEoUU2QhKipCBSVDedxzMOPHHz/K8cQR2l/OG7b0lzrLYVvS2s6pp5hJKl7yUiXyYAlT+PHQ== 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=cNxRu63gd9iA3IoBDZDV/UAG3M1Mxlt7NrUc3g9WuPU=; b=bnmhLn5ZGlRKFbCMIFHbcfTXZsALrj8rG/mJ16kkuKcjE09e6hjKHdTFS7psr8gUSWEh77sZ2qrr5gNge8t5IfC8We/ZPGzqKSJmEbejYsQrUSAFWXPeHjSwcCX7kEls+E4iUa49RSZlwschLwaEgbjXTkx6ceFT3+prmh7s3M34Idm8qLplcqjWtji3LyPl7pW3OoFc4BHQVDj7NXqPL17zMPExd8ca4iS7avEhCzuHfoA+rp1WN+gYLXHC37y9aWOfQBgblHIRmzShOMg/NnCkS+s7hRyFy5t7r8WIM2jEUhMhOn3kE311FPWbt/hAftEPAp3hMbFBVe7c9de9qA== 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 BN6PR1101MB2274.namprd11.prod.outlook.com (2603:10b6:405:4d::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5332.12; Wed, 15 Jun 2022 01:48:47 +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.5332.020; Wed, 15 Jun 2022 01:48:47 +0000 From: "Xia, Chenbo" To: "Richardson, Bruce" , "dev@dpdk.org" CC: Maxime Coquelin Subject: RE: [PATCH v3 4/4] doc/prog_guide: add reference to virtio-user from KNI doc Thread-Topic: [PATCH v3 4/4] doc/prog_guide: add reference to virtio-user from KNI doc Thread-Index: AQHYfObaTPLCJmDrxEWSUpz+uvKZ2q1Pueiw Date: Wed, 15 Jun 2022 01:47:41 +0000 Message-ID: References: <20220527162659.129022-1-bruce.richardson@intel.com> <20220610153535.659076-1-bruce.richardson@intel.com> <20220610153535.659076-5-bruce.richardson@intel.com> In-Reply-To: <20220610153535.659076-5-bruce.richardson@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: 01ed18ce-25f3-41db-d0b2-08da4e71305c x-ms-traffictypediagnostic: BN6PR1101MB2274: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: iKuRi2V0/VpyghrgQ0a/WqioDvyPXD8BD1SkU339Br8naFgoDfMazhx8zPuErq1/9m0ykj7jjmNIatCFKbX3Fir6hlk/Eo6j6zTWSCrkb8BudTcsYcdYAqt4h4O783UdpUzVO2fjKAkDdW/4uAzonTwzvh7Vlxqd5LxAlRnD8Zurf5f6/A5FWC01VR1/7WZLoOC2Tu0Qs+oXX9vwYcvrjxG16ntlKl8qwPTvLDo8/HHpwKoH/g7cma7vaYspyevVAsllVqn+QyxjAsTe6ZWnMHmBJt5QdGDtDTawVQJaVANgY0qgmiUb0JUzMIgJUqjMNmB2RVWyp+o6KhgAeVfCfk3bgGk9LKO6iftZPDASFteNO9NOXLBX+DchL3cPY4OQsXTCQYaY2qv8afUiPKh0NWbf5NXUmoSvWe4z1JhDcvEUbUiUEdPkMYzOI7zIVAfa9DzdDO0nYXiTYqvDvwLGhxZRf3JMJRY+wa4o6xXQAF+JOZrsQzEmLeDcKk2CEzJY5nhOqinuiu2fBphI+CUXooLJkBNq2vgLa5JlyAuw9LCJo48H5YvXEXzQZae7ENp+2vVjapqyxlGWClqb1l7Qxx6WWqxPL+5ElZKFJ0uBwsTU6fe1Qn9HSlsADXo6cDN9lhEwD4MMtK6PS3Tky66zBZ1Hfx6I+Nsh0qSmqIbl4WOByzl6DgpPDkYt42bwuXVCje+HhNlsOy+9WTId7Ed82g== 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)(366004)(6666004)(82960400001)(316002)(33656002)(2906002)(186003)(122000001)(110136005)(9686003)(26005)(7696005)(5660300002)(55016003)(66446008)(66476007)(64756008)(86362001)(53546011)(76116006)(52536014)(4326008)(8676002)(66946007)(66556008)(8936002)(508600001)(6506007)(83380400001)(38100700002)(71200400001)(38070700005); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?KpI8Sk0xiJeuomigIZ1MG+IYwPeCRrIzKT5KSJg3SJ1pNmgSQSXv9r3aPAfk?= =?us-ascii?Q?1PBhxxBny9lmggFDDY6pcsZgzYQGdNOrOfu0RYbKzn1Eg/bgbACRAlWcas7l?= =?us-ascii?Q?3WtytX5dpZ5PdFnHJphJ3IvWe64JtP0DyFp2wsLkWITc+cTnw7wANMkl+X8P?= =?us-ascii?Q?HsSB+Ycy0Fp8RSDoWdu0LjWFa19U0lcOOVooDiKvJA2gdzW6b7AW10Kjuk0I?= =?us-ascii?Q?ZkxYs/vloszb5q1CU5IaTLhImnS6lF6UTVH2oHMv0CJzK0a1mTpWX6o6sTSm?= =?us-ascii?Q?TQBuYZkuWvayu4jiM1J1yPNJzaX75sm+w18cdFXxf13FiHjx0X5LMhCqqQUa?= =?us-ascii?Q?N+o4yH0PpyTcTVchVhe7U/Kyn38D5m/lvKL1LJIpROlMET39gw9Zg/DczuQi?= =?us-ascii?Q?46ph0JJbnfc0rSc63pqCqYlJB3xzRT/jFR+O5RkJYaDYwHTDMjKKmEulagTy?= =?us-ascii?Q?MzDTpy3qd1I2IHBbatdjrYogar/sg2CKuo5NDJRyJQwFULC8wvao8Rkj5Dat?= =?us-ascii?Q?0We7z+Fvu+I0UTFW8WVOnfuFGyzNG/FSTEcF85cmjgYOF3oxhH5mh0b4m3FV?= =?us-ascii?Q?Bp817W1u016kZA6FPJxLERX45kqpP5llnYaDWZSRMPhiXjR7af1rBgfF7A1V?= =?us-ascii?Q?8f3WHIbs4O5m6T1iFGoBNz9fz4yKAYpXvb2qScYN/d/wWoHhI5h8G0q6A3qI?= =?us-ascii?Q?vMhT2BpOb1b+dqzvXqZVuk+ObRNzKe2sTz5DPHEzm2HrzLdMc14VNMoTc+ri?= =?us-ascii?Q?b5B9CpAvjGx8fQUS7eagOFFQccnT6nzTI69LkuFgEonqsg526zTbuCV6BmTJ?= =?us-ascii?Q?O/A221D8tp9BdbTg0mh8v91qMc5y+JFM3GUh0UBf1aQDNUKCNHYvoia0qU8S?= =?us-ascii?Q?qSDuxTGk/nH3I3oCheUY+U28c/6+CPka61sbBnhaKhTQ53ZpkqW2yVm6gtZ1?= =?us-ascii?Q?yamGywTbcKHJ5P9wKJi9casXtqyr25uXM1baXG0XtU+sE7dzGkA03OC5FQi7?= =?us-ascii?Q?Uf+KyxAolNR66XB3qHte/6fIYYIuPyNkEnNDG1icgHiOjQzgqxpJfHZIOrHj?= =?us-ascii?Q?y5qD8WuFLx6kGNL7WpWrndfh2zfWUV7To4fMGT/IgNMAqN+O5gsOqLR7ApoA?= =?us-ascii?Q?EOWNIzK8nG4BJN1zxNpAFLglqfMnSA1tVnvC7owy4UR1grVEEGIfW84FbhWC?= =?us-ascii?Q?vekGsfITH3DRxr44aGnKfw38cqZ/SdQEAn0HAikfw6sMg4yovmrqyROcZL4C?= =?us-ascii?Q?QYLNUiR4fHVXpv45htmHsUimQJl6Viu9ccaqw0JYJ2bq307OK3y3uH6lS14K?= =?us-ascii?Q?YaKtxjydGrjOo5jTh9ORVxmnpZ44OxFyNxCRId/rndf7NzIygiLAPGTHZjIs?= =?us-ascii?Q?U71/h2tOyCEUU8+FCHcVIyN2+8QltlSoJDU41agAcX+Uzb+g16LP2H4G94af?= =?us-ascii?Q?ytnK8Q1QCyJGY/dSsuZCbSODG92tKEJLEtjePrBCHW++PCaS2fPRdCAPIiSG?= =?us-ascii?Q?kN6t/WMIUmFE5/qi8DeDaUy0tIpXCjuE4YKfZgyj6Edahds715TcX/voUXtH?= =?us-ascii?Q?nFv/CBviOXylW6B80hkVN5LkVElFGcv6XAGWUW8ADYmJo13e8tweR/jJ0ZN4?= =?us-ascii?Q?XWxugo2BMygXo+pQ/SxcoNrk4QDDUoN2OMMYoNJDL8IZ1xG/i17cuGVghPgD?= =?us-ascii?Q?B13olq4QzAKmyKGimCrqdnTQfmCFpSQewudc0NutdI9j+vxHLnRjyPJvH3/z?= =?us-ascii?Q?5WOLYH+ndg=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: 01ed18ce-25f3-41db-d0b2-08da4e71305c X-MS-Exchange-CrossTenant-originalarrivaltime: 15 Jun 2022 01:47:41.7767 (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: MI9SeYCDGmkAaMcE8ZV1Yd1sxbFV2gJuC+V2GlWjWWBhAx0S2+WouwNCtruZ9L/G8hjxHmovRbnW+yAyy9Q1oA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR1101MB2274 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: Richardson, Bruce > Sent: Friday, June 10, 2022 11:36 PM > To: dev@dpdk.org > Cc: Maxime Coquelin ; Xia, Chenbo > ; Richardson, Bruce > Subject: [PATCH v3 4/4] doc/prog_guide: add reference to virtio-user from > KNI doc >=20 > To help encourage use of virtio-user in place of KNI, put a reference to > the relevant howto section at the top of the KNI doc. >=20 > Signed-off-by: Bruce Richardson > --- > doc/guides/prog_guide/kernel_nic_interface.rst | 6 ++++++ > 1 file changed, 6 insertions(+) >=20 > diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst > b/doc/guides/prog_guide/kernel_nic_interface.rst > index 5248f9622b..e021cc69b6 100644 > --- a/doc/guides/prog_guide/kernel_nic_interface.rst > +++ b/doc/guides/prog_guide/kernel_nic_interface.rst > @@ -6,6 +6,12 @@ > Kernel NIC Interface > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > +.. note:: > + > + For an alternative to KNI, that does not require any out-of-tree Linu= x > kernel modules, > + or a custom library, see :ref:`virtio_user_as_exception_path`. > + > + > The DPDK Kernel NIC Interface (KNI) allows userspace applications access > to the Linux* control plane. >=20 > The benefits of using the DPDK KNI are: > -- > 2.34.1 Acked-by: Chenbo Xia