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 EAFDFA00C2; Fri, 1 Jul 2022 08:25:34 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 8D7444069D; Fri, 1 Jul 2022 08:25:34 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by mails.dpdk.org (Postfix) with ESMTP id E2C4740694 for ; Fri, 1 Jul 2022 08:25:32 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1656656733; x=1688192733; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=aG4vTOIOLZ8jUsmu4Z4BMdqzlXY2yJl9EIGZkWWqTJI=; b=jFVZXM8+GK7fMFyQ5eKFmoW7f5l83NIc0H1WxZp0MzfrHdmdOa7nidyF c5AfEwYoT/1bgu2tywAtFy/vgE+h+SNnnGKleceavqTImE6udss7Tlnm/ ++ZHNQWwY9fUQfmfMT9HkfgqVq5AS5uKzxj+qohHipFRT0WNC8LcYXYtQ VcHqMFZGQdWIsfVncEvXnVd7WNL0geUln4PACpsf9SU6WJZt2bmZYjn+Z oFO99ufCi6b5fLxK/iKmi4lwBeDFruZ7zlaJeRn0NUBvAycjtwCIy8DLD RJCRrpSh4899zwnm9KgfH5JeMZ0z2AQD82zHs0KWwKrQkSocmiXe8X259 g==; X-IronPort-AV: E=McAfee;i="6400,9594,10394"; a="282596732" X-IronPort-AV: E=Sophos;i="5.92,236,1650956400"; d="scan'208";a="282596732" Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Jun 2022 23:25:29 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,236,1650956400"; d="scan'208";a="659314561" Received: from orsmsx606.amr.corp.intel.com ([10.22.229.19]) by fmsmga004.fm.intel.com with ESMTP; 30 Jun 2022 23:25:29 -0700 Received: from orsmsx611.amr.corp.intel.com (10.22.229.24) 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; Thu, 30 Jun 2022 23:25:29 -0700 Received: from orsedg603.ED.cps.intel.com (10.7.248.4) by orsmsx611.amr.corp.intel.com (10.22.229.24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27 via Frontend Transport; Thu, 30 Jun 2022 23:25:29 -0700 Received: from NAM12-DM6-obe.outbound.protection.outlook.com (104.47.59.177) by edgegateway.intel.com (134.134.137.100) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.27; Thu, 30 Jun 2022 23:25:29 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=bciHgJDrff7P2QrFEEYKwjLlZ6M+Lk6Nhm+JMRAO0UCHt+B1FmWMIxnFtcCQrni4QKFr0xeQFV4yG1WpU0B89Cpbr7S75s4FOsfTYJOpCOp88upiAhkeJljxlKUXwQx25bSZktb3dk/pJ6mMVam6Il3hkplZh8xuw2GXpbEue7Ygclnvwhh3QHH8+vZgrUGPzErQqqeG2VbZiZatLBX+zg7GJ3MV5QBinM2M2LdWVcgGu/G2S4FzZmFgfBAiQTb131urRRlJKjAvOF9tRtpBHVrMaHgS7j7yV0sRNJkl4ADRtwdaxbFZb86spcNRXD3C9KnIBNGGyzHd/kEcu1ToYw== 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=dPJ2ho7I/tzUN8TrVQsMCm5JDcGN0ltt+pkdxgjeiEw=; b=HOEeHUs4V+Up0qy+iI9HU+mawlmWF54uoCh0dJbKx07zGCsjJEAP3xoRj8WvykNFYOLgYzQd9lba0MLdgx+fNdKs7WtvkBM11A2YHwCLMhtdS3IgKfSgN5btDfF6r3txUOsuKm0//7cRDr9tDUvE1xMJsFTvRx/px68CYe2ememiGcfsXgg13f9LESgqT5qq570aPlCtYcsn65B29zdxMXjBO/hRikQCaTe0wqgHA67W1pus9rPojnlOJQD7e09fQ6LQpYER4DhX2SMZbR4mwmmjasrR9leAHsRFwQJErbQnRcrkNU7oyFDv2XTo8ostPIyh3Bb3x2wjr9kx+3n+wA== 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 DM6PR11MB3530.namprd11.prod.outlook.com (2603:10b6:5:72::19) by DM4PR11MB6501.namprd11.prod.outlook.com (2603:10b6:8:88::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5353.15; Fri, 1 Jul 2022 06:25:27 +0000 Received: from DM6PR11MB3530.namprd11.prod.outlook.com ([fe80::d521:dac4:a9f0:16c]) by DM6PR11MB3530.namprd11.prod.outlook.com ([fe80::d521:dac4:a9f0:16c%5]) with mapi id 15.20.5395.015; Fri, 1 Jul 2022 06:25:27 +0000 From: "Huang, Wei" To: "Xu, Rosen" , David Marchand , "dev@dpdk.org" , "Zhang, Tianfei" CC: Ray Kinsella Subject: RE: [PATCH] doc: announce some raw/ifpga API removal Thread-Topic: [PATCH] doc: announce some raw/ifpga API removal Thread-Index: AQHYjGWdG9o/ggajrUW2l2FN9kwToa1pCv+ggAACBxA= Date: Fri, 1 Jul 2022 06:25:27 +0000 Message-ID: References: <20220630094129.2066164-1-david.marchand@redhat.com> In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-reaction: no-action dlp-version: 11.6.500.17 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: 040f1fe2-c1ad-4675-6389-08da5b2a7d70 x-ms-traffictypediagnostic: DM4PR11MB6501:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: E/qgcw+TRJN/1y+mipdPiW+1NP+FHFhEfRUb0aVhoPS+nIap6PcdzaBNM4+FXNgBlBs8sqOfgmRlBFFc3aa7HoSHoWz194S9UqTK0HC3B51/mHxY4yuMxOHrF0pDl9gqdy3J0rh/FUYZ6HGvkTVh/SQ3Q63Knp5cyGy24lqcCJxeCuGBAOqqFwf/RT7nTFTPmGc7lf9QBoYKeEGVtRyj48ju/vwd9AOfLogyjkEU9obA/nTt9eLxnuiGoszTemsgZGEeZzElOat32L1Vd38cxMELm+v/ROR3oLvv3SYDTQOybi9syAml7ub8wV6AMApL02ZLYKuFM8MiiaUdpSYZxON35c15Yz+FoBSRD7pq+drRq5taPS8IAYlFx9Cg3r1VPqHtcV6xj72Xyp2F8R0bWVsOJsMsR4owxqcvEhZLhTpXo+TAbPCtusbmJvcGoYt/04FKp9Owo3eOkdYRG2vttZzlArB0BNYE9i1gGISssfJkLRAwuuQfoyEXsqQwd9bK9CE+tdiOHfZHhn52t85U+nb/mtbViovt/RXdhgjdFsfq4mb9muSeJRt4geWcPWnlpce9+5iFdshl41RY23OwDiu89rTpV2H/FTnJmiZUbPk450X47+eVmR3xyYriX9zUqX6kQrJ1hwbEq67n672x5TvJT3wGoNs/RSBF+p9pve7EU7Buw+8QIbluexRlqFspx01dY0Jv7Il191m5xPM6VsNxkro//Xmxwm7p31IlrvexyfOnfQ87TXk8zj/K84X2Sco0l/WxEuLaH4ANaxQfk6Vt60zN0Dv3/ndhRnklQ5eVk1a5w3LP2cP4LwNOWZr47MO3b2ejLsA0XGoyrqcYMWs/jUcsln6JnP0pH5X9bEQ= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR11MB3530.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230016)(366004)(39860400002)(376002)(136003)(396003)(346002)(110136005)(5660300002)(8936002)(86362001)(82960400001)(6506007)(66556008)(2906002)(66446008)(478600001)(38070700005)(186003)(64756008)(71200400001)(4326008)(38100700002)(7696005)(66476007)(966005)(316002)(52536014)(41300700001)(33656002)(53546011)(66946007)(8676002)(26005)(76116006)(83380400001)(9686003)(6636002)(55016003)(122000001); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?Pdl1g2iwUxdXoiE8oXD/JemlBEOgOpt65U4OqTvQRFfCVFS4jp2esJhl4D5M?= =?us-ascii?Q?NEUKy4LmI2h2NHFmkP/9ttUJZx2UC61KUM4BPh56l6zPSp48rOqiKWq262aq?= =?us-ascii?Q?BV9Oyr5V+rhSNCRsEiis+Tq/7Kre4MujlZeqYEl1YX1oUkZKOWZ04LCJ7GGJ?= =?us-ascii?Q?kMS/HUyTQ8zoxPOOj3/NMB4rBXiMYacHsSXSRO12VWz5FF21cRK4/LbBJ0Bx?= =?us-ascii?Q?X4riSzVAvzxUkVQSd8Wc/HJeJN4lUMX1K5Kl9RaklNhucReqp2TOLtUhiiIr?= =?us-ascii?Q?mD4noIRucBZkmg9B6ql1h5RsrhZOyMwhkoY7BwSHegbW8659GRSOXK+K9fH0?= =?us-ascii?Q?X02IHas06OiUpmzZcPWFQcJKXu+Bo81R4cI/NmB0RAxGAOdFkQdcfYRwPGia?= =?us-ascii?Q?lcnCWdOW0iz7xFbrTcXa6uBkSgK7M5dy12JbbhPNh5K9edOWeMd3OzV6eO0o?= =?us-ascii?Q?LZ9ytdnlrQMygzJ+4IFqlbxV01iU8vsvtRTk4rxDL9FZ/2aJf6VHpX893IzC?= =?us-ascii?Q?miuF4LGBnBxrHVhvaosp74eqhh33DADU199ZSTUekmm+5htiTXldapqixwbm?= =?us-ascii?Q?JFYOjuZNfNai15W67YmPZHqPz0I6iiBzNo01mcn79GOm4qkserDxPCSGR1q6?= =?us-ascii?Q?wDmmivQ37mT7Es83sjQIDFxPBEfEMzAYoRunfgIijbngUSLe9jgIMzNESeJI?= =?us-ascii?Q?SmrHxHwSnCV/7OIGoBJ/vWKgnfMH0u6Ie5SrgOpUl8gDTbFrErToDissLZ1I?= =?us-ascii?Q?Sz2rxmm4+Y2BW3u4QC92VAcRGE0vrO+fvUInsNjwePd27CmFGI0FYaGZM2zI?= =?us-ascii?Q?muONskojT3UblrA0CbxcZkt8BLDnHqidgkBcExi2sWiq9pWAPR8ACTm37Wth?= =?us-ascii?Q?MH+xm4q2icmOdVySnyeeu0dsyQz/gnkootVhbOQxwdXhm8wqQZFo2LuCKfK5?= =?us-ascii?Q?E++UVD9DG1z3rTID/8BEy4ifVtOHAGUVsS99IWlVDra2arNYhoEJ44UMa2yE?= =?us-ascii?Q?+OvPmBZQg7T6YSPJm4dqlpDVLF6UNeh3BfpKsJs/vr1TCacXLobLacaT3zh3?= =?us-ascii?Q?D1DqHYIXjFAzTy5PcHiy5wIZRZboglFG6WMgUXQPqTUSQQ1ZZH06r2H/l9cK?= =?us-ascii?Q?dzt3D38w5xpNFvz9x3CtaJzHzebkSvhWAvnxK7/dfe9fTils6OKKDrkqmx/p?= =?us-ascii?Q?1oMouEEDQdhACx1UEH30uNb6ts+vhmGO7ARSvDo80ElrsHx7y8DDSuf6uZ2Q?= =?us-ascii?Q?eIGKgTKGauc5aDbpiMQYpuw0lJ/YYNVcACdPqJuJqJhzvZ5IiErjHIbWPC1a?= =?us-ascii?Q?mHPgGhlvdrXdPWlNFIJGXi0xA3d1POYHVfxtDgAgzc+tZWyF4AB4wLfr7L5P?= =?us-ascii?Q?e1S/niKv9wzXj8k2DCtujGPRDX0XZ7Qmj/rWstxBhqu3l48pjyqoYrO51+BB?= =?us-ascii?Q?T4Gl5ELiHZoRC9s8Hb5x5C4ZVZUtr74lR+IBY4DrTO+0di+iDYAOnT07e1mU?= =?us-ascii?Q?wcMFyQtHF7Fmlk5j/DTu/KRr2fWdeQAHB7oP4FILxT7VcuzKryBVlNsy7vRg?= =?us-ascii?Q?5+ckNVIh5tnrqqL5eXfjs9yQq6KZatzE9LGcCbom?= 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: DM6PR11MB3530.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 040f1fe2-c1ad-4675-6389-08da5b2a7d70 X-MS-Exchange-CrossTenant-originalarrivaltime: 01 Jul 2022 06:25:27.6993 (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: GgFa+D5zEcTDE1t+I2CnY+tFdQJg+ZcOLcDovxE+HndyU8r1OMa8XctC0KLLYA0KOsAOoRZs9AEFvURxXpz/VA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR11MB6501 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 Hi David, > -----Original Message----- > From: Xu, Rosen > Sent: Friday, July 1, 2022 14:16 > To: David Marchand ; dev@dpdk.org; Zhang, > Tianfei ; Huang, Wei > Cc: Ray Kinsella > Subject: RE: [PATCH] doc: announce some raw/ifpga API removal >=20 > Hi David, >=20 > Got, thank you so much. >=20 >=20 > > -----Original Message----- > > From: David Marchand > > Sent: Thursday, June 30, 2022 17:41 > > To: dev@dpdk.org; Xu, Rosen ; Zhang, Tianfei > > > > Cc: Ray Kinsella > > Subject: [PATCH] doc: announce some raw/ifpga API removal > > > > rte_pmd_ifpga_get_pci_bus() documentation is vague and it is unclear > > what could be done with it. > > On the other hand, EAL provides a standard API to retrieve a bus > > object by name. > > Agree, this API is used in an external application, I can use rte_get_bus_b= y_name() to replace it. I will submit a patch to remove rte_pmd_ifpga_get_pci_bus() after DPDK22.07= is released. > > Announce removal of this driver specific API for v22.11. > > > > Signed-off-by: David Marchand > > --- > > A RFC series of the intended changes is available at: > > > https://patches.dpdk.org/project/dpdk/list/?series=3D23811&state=3D%2A&ar= c > > h > > ive=3Dboth > > > > --- > > doc/guides/rel_notes/deprecation.rst | 2 ++ > > 1 file changed, 2 insertions(+) > > > > diff --git a/doc/guides/rel_notes/deprecation.rst > > b/doc/guides/rel_notes/deprecation.rst > > index 4e5b23c53d..64d649777a 100644 > > --- a/doc/guides/rel_notes/deprecation.rst > > +++ b/doc/guides/rel_notes/deprecation.rst > > @@ -119,6 +119,8 @@ Deprecation Notices > > * metrics: The function ``rte_metrics_init`` will have a non-void retu= rn > > in order to notify errors instead of calling ``rte_exit``. > > > > +* raw/ifgpa: The ``rte_pmd_ifpga_get_pci_bus`` will be removed in 22.1= 1. > > + > > * raw/ioat: The ``ioat`` rawdev driver has been deprecated, since it's > > functionality is provided through the new ``dmadev`` infrastructure. > > To continue to use hardware previously supported by the ``ioat`` > > rawdev driver, > > -- > > 2.36.1