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 754F4A0032; Mon, 11 Jul 2022 04:16:16 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 0817440684; Mon, 11 Jul 2022 04:16:16 +0200 (CEST) Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by mails.dpdk.org (Postfix) with ESMTP id 7EEAC400D7; Mon, 11 Jul 2022 04:16:14 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1657505774; x=1689041774; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=cbjs1fXcZo8OiJBGA/6YmkL3WDOwsqGC7r8xSb1ZbKU=; b=H4dfimWpUaNNA6j9t/psB6zKUw/SOhxfCOmwfQyqzyKUsFFRcdygwMKy q6uY7KETvdPbortJqGCShnLg4iqQDlF8FEbOSS86fVziYjG9YaoI6ic2L 6lK5YdWSb05BSZRFpy4npgRaJn89AbuDmsVlquMnYl+CguOwG8G3ktz+h XYzWsmV8/gP8d68bwg4tVVVN1rXHs8+zuJuhXsTgq2cwJnFpU5/cf7A8E 2k/B1NXqVIGuLpld12z32nYjkUUgi8Q/+JVwoN+mKEaofTzCW9XF64E2x +g2Q1Yn1p9uVCvrGxhgrTUUkGJUlplpFp998uwA8WQSnU0IsP06Kr/EYz w==; X-IronPort-AV: E=McAfee;i="6400,9594,10404"; a="348541563" X-IronPort-AV: E=Sophos;i="5.92,262,1650956400"; d="scan'208";a="348541563" Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 10 Jul 2022 19:16:12 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,262,1650956400"; d="scan'208";a="736934513" Received: from fmsmsx606.amr.corp.intel.com ([10.18.126.86]) by fmsmga001.fm.intel.com with ESMTP; 10 Jul 2022 19:16:12 -0700 Received: from fmsmsx609.amr.corp.intel.com (10.18.126.89) by fmsmsx606.amr.corp.intel.com (10.18.126.86) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27; Sun, 10 Jul 2022 19:16:11 -0700 Received: from FMSEDG603.ED.cps.intel.com (10.1.192.133) by fmsmsx609.amr.corp.intel.com (10.18.126.89) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27 via Frontend Transport; Sun, 10 Jul 2022 19:16:11 -0700 Received: from NAM04-BN8-obe.outbound.protection.outlook.com (104.47.74.43) by edgegateway.intel.com (192.55.55.68) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.27; Sun, 10 Jul 2022 19:16:11 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=oMOJThpiL1wfTEr6+bli6FaUH4C/ALzK2vW5Kp0lIHhwfRran12dDVqFcPATHFeP4ueu9dMBrRKLFXYnV0qQ0kL9ON7/2DpMdcFaBfePx3OXoLKgt6Pw57YgVDEXNDAZH7c1w9tfis5McqTOs9hRp8lgA628cltwMyBxEfZJ2S6RVL6EAwRmh52VrBMIWNzCpeEJ7a80AIppebJEZ71drrvnaFNbWNy84tuUHqYP79/NnuBPKR57ckn//ButT1GWKJHeJhYBMZWFZlTMFAKO9DhIJ7qpDS9mZN7KM2BSR9js82m1BLjh6qLx/F1MtUm+uakiTS8myBDD5kU4D/eMvw== 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=iF0UqArnLvVrazWeJ5We3upEOu/KT5cnEuPskU/sO9g=; b=FL53TpypqVJZRzK+MY6wALbo//5re94FKu4GHjJB5C0Sw6ynTWBNQFpQq09iLjBg7JkXHOGb1Q7VQbrIwSWtkWPisQJQ1R0gbhHgtiXrf4/WW+ygEoLpCyxy0omK0pJxrXlzpizPgdKGxdhK5JboLoho2/cJxE4Yr/q+1e5MSln5W2SNAZTGRJ0qYzTZMZoiWuWjfWU9ez+ATHub0HPbtm54iauADBPN724+xfmsVwV1+1X/vZ01lU81jKGJEOOab1k9fJd57M6X57KKJt8/hcofiKZkbsdxGJ89jhCjuU/lVvJMhSEMk8DHssmj88/HX8a2sgz5Q5n/Qp5BJRd3KQ== 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 PH7PR11MB6356.namprd11.prod.outlook.com (2603:10b6:510:1fc::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5417.23; Mon, 11 Jul 2022 02:16:04 +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.5417.025; Mon, 11 Jul 2022 02:16:04 +0000 From: "Xia, Chenbo" To: David Marchand , "dev@dpdk.org" , "techboard@dpdk.org" CC: Ray Kinsella , "Liu, Changpeng" , "Harris, James R" , "Walker, Benjamin" , Thomas Monjalon Subject: RE: [PATCH] doc: announce marking device and driver objects as internal Thread-Topic: [PATCH] doc: announce marking device and driver objects as internal Thread-Index: AQHYlCTfppahdl7CmE+jWpLyXng/9614amPA Date: Mon, 11 Jul 2022 02:16:04 +0000 Message-ID: References: <20220710061736.973563-1-david.marchand@redhat.com> In-Reply-To: <20220710061736.973563-1-david.marchand@redhat.com> Accept-Language: en-US, zh-CN 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: f1017e63-3013-4b55-b230-08da62e34ee8 x-ms-traffictypediagnostic: PH7PR11MB6356:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 5x2voXgkn3M/Aqr2wzLnJXF3IiqusU+HF8HHMc2NfS6eMvAoxuN6bUTlvkJ3qo9zz3e3kAkwn8tLxzZkgX3sDfHByx1pJs9u3jxfEr//8uBCmmSmiXMZGKan/6Bsy8/B7EslnEfh8Wroit+hpIa4s2y/qVgctnBby3IAuFieAf2uxTEN/fuv/ODPkQVjB7clBBKs1agdNeVRDXWp4Ul1Y0SC679E9VOwVMugpN59zE9xzlMtK0QHHjI7sSKqzj6GVrrHtmEtpO+jyyukGJqRnWDDlkcCuXEHAb4bnF2qcAuffJP6VADbMOcHZtDtaGWgNz6XqwRa+IA/W445Vu8ySrF35GajdBeFuVXydf7MlNZKVY3tQRfm+BruiwaI9jPu4eGTQ763b/fCLd0+Xiw4igyKbBSAL6FPUtFSmqQQMg7UzgnjpnnA7nMTdFy7VJRNxCl9hGF6zgw3PLuqiDiRFYOYuxQLue3pPb2JcVqJh+EM84rJ9b9EbO3Q1qwCSaWhe48PCJZO5lTgNjUEO8RDbONBj+qxLIKJV2WqVevzb9NvnfghNapS86KIXRSc5CIrpwk3iWLd+HIWgPfMBQrkS4E+uLoDu7y5jCcuvL1RZn7i8uwU52id4fSIOkGTuZStRocGitm4/IUJV/CtX93oVOPzYG1fdSxhhHUGLor5h8YFEdl8hTEFIc5TYWyNs1Snfyhs3oRh3MKk6ngTOsk1X8rGSuc9qmFa2jswEWRDnxU0NeVRltnEHYfNmZmjnBqUKbJTBlSkYBWJovM6TE54IJZUMYkNt7xpi6tHQYDHn/FzYdBE+Q0ztFkK9VB8MPESsMXfY+Anr8ytVMHx6gY8B4MGte6djVhX0TfxlrK8gDmRLh9pLYjCRbxWmKrjWCpCgXN0r+myyLgS7PdnwhwNcg== 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)(136003)(39860400002)(396003)(346002)(366004)(376002)(38100700002)(2906002)(41300700001)(316002)(33656002)(8936002)(55016003)(5660300002)(83380400001)(122000001)(52536014)(64756008)(53546011)(4326008)(66556008)(82960400001)(7696005)(8676002)(66446008)(66476007)(76116006)(186003)(6506007)(9686003)(86362001)(26005)(54906003)(38070700005)(110136005)(66946007)(71200400001)(478600001)(966005); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?3BkSc9A56NSI+AA7UnhREEY2t5v942WwZUbWOakAHS4TwC8fwVwySvu/M4N9?= =?us-ascii?Q?zwZCZhI7TzWYXjou4/B5IA+qqmB+zZ4yWY9II5zOw3CJUwWzc65pLNsExAME?= =?us-ascii?Q?WSvp5z/c+h3UwJ1xYcZDn8ZY9tFPwP0a1qqhdrDS85RHyg373W8F+mS2rTQB?= =?us-ascii?Q?j7NCz7r4TcHYyfSjGnE5OsK9FiNttlliVSHvaek4CeZV7tZtyPrzAIrJlLa4?= =?us-ascii?Q?iqp6g+Sh1ev3OFx0j2SusDJaOQpIh3pvraSvSip0t85gHlyDK11ZOkkFz+TN?= =?us-ascii?Q?uCJRQ3E9bd2QaA3/J5enHUnt2lgcKRHAUlOWJJ9t/k5QF/uDHEy5CoSbPD/9?= =?us-ascii?Q?DiF85xG7u5Ggwz02mem5BEPS4CCJpAxQ95MJIFxgpaGBJ7Z6KW4etVWhQpaH?= =?us-ascii?Q?5I3ih31LZTy+g7nfXJXnqOkYuX+K/0o5bBXcS4hr30ke7VYvJfxfKCUgEfvB?= =?us-ascii?Q?K2XoaUnBOxT9wCks4sQjIT/YELEtSVHh00INJe4yZ07qbOPVHXmUvkiQua5Q?= =?us-ascii?Q?00pAzZZ8NJlc8M9f1nIHhf0rcmdxkkBzPVtUsePVrVUxFI6hpIyQn0lubpdb?= =?us-ascii?Q?oSWrKnqJuVZYjQUOKfVzvacvqRet1BXAKFl3rctmyIP9hNwyp2KtAkl3QlU6?= =?us-ascii?Q?2KghgfbylkuP/CxFzETAwQMDGTxufdZF055haXiKIPu6xBk04vTDI2G3UoJg?= =?us-ascii?Q?9MsqYM0/WgR0sehKlthBG1Wz4pWmO3rEHnY2vwIRo4Pu88ZpsoVuCBWE3ObB?= =?us-ascii?Q?1J4uyJKbB9XmULPEe0oDRQL4T1wezAR3zxs9l1aMtuh8dxYoLkw37ev8uyql?= =?us-ascii?Q?o7SssNgtZkgfqZ7ruMp8/Ec3jTkcCM/5Mb6wtu1CG4wyInDIPPWZvYySmNQA?= =?us-ascii?Q?p3/bCRMhAH48NYxc5Yu6SR8KHA0CJptx8D97Q6JHKF2F4PyFp3mfcShNQ9of?= =?us-ascii?Q?iEZqXR0yXQ2nZOqwJpQYVtM80bql6LkI8ZriN18cF8twowPLrWcnMLR5Axb+?= =?us-ascii?Q?FWAubSzSGqIW/Z+DY/c4SaV0sjyuYvg3OsnlEZO4kxatbYHm8nIwqARMjw5k?= =?us-ascii?Q?yIdccidQxeGPs2i5ZHHb7Km7AJx82BJnQtCQuO+ZoDnyOMOXfS2wTA30U+/7?= =?us-ascii?Q?FaDturHfB6GtsxPZQy1Q29RY7tU2cRmmiBFR/LgHXKXFvYti0NOyUY1ljA4K?= =?us-ascii?Q?0LoCj8A+qeFkq2QyuU7s7XI63pP6y74TH4U9QliFxNanFMzSKiau6YEhW55f?= =?us-ascii?Q?rK/AEriGnvLcPdwipHnRle9W7V3Oiipuh7W0MF1cfwt0GKO0qaFmDRp+QnX+?= =?us-ascii?Q?bs40SAkc8WO//FbNsFhtLqivB2bgQYbrpsRpkfEFXrBYSCUqm40vgBoCBu2J?= =?us-ascii?Q?A7Q9ZxJqF2e3qN5B7N1vT+mZ47trhY7Ywxn41whzggezLENbQA47y1GDUod4?= =?us-ascii?Q?VozlbBYC2tp9D4mhAFjA9858M18DCvmvoY9N0UmXewxMF3di9+zZBhTBRejq?= =?us-ascii?Q?wIW9E4BiG+zA6725G6khQL+ZiQdzZ+062+8P2+tIx3Q8UKzGNIvKFpRYHl0p?= =?us-ascii?Q?jykjHoe5JAq8yuVzpS79F+caZAsqkqkLUZsJnbRe?= 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: f1017e63-3013-4b55-b230-08da62e34ee8 X-MS-Exchange-CrossTenant-originalarrivaltime: 11 Jul 2022 02:16:04.7005 (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: l6LUqvQ8begprOn8CP+pSMDofoReuTIkxGTHKbaqHI3yJR1gy01gQLJfbt33j4fFLNvtylB+9sN3JuAFjW41PA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR11MB6356 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: David Marchand > Sent: Sunday, July 10, 2022 2:18 PM > To: dev@dpdk.org; techboard@dpdk.org > Cc: Ray Kinsella > Subject: [PATCH] doc: announce marking device and driver objects as > internal >=20 > rte_driver and rte_device are unnecessarily exposed in the public API/ABI= . > Announce that they will be made opaque in the public API and mark > associated API as internal. > This impacts all bus, as their driver registration mechanism will be > made internal. >=20 > Note: the PCI bus had a similar deprecation notice that we can remove as > the new one is more generic. >=20 > Signed-off-by: David Marchand > --- > doc/guides/rel_notes/deprecation.rst | 12 +++++++----- > 1 file changed, 7 insertions(+), 5 deletions(-) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index a9fd6676be..b9cc267b30 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -38,6 +38,13 @@ Deprecation Notices > external users may still register their bus using a new driver header > (see > ``enable_driver_sdk`` meson option). >=20 > +* drivers: As a followup on the work on the ``rte_bus`` object, the > + ``rte_driver`` and ``rte_device`` objects (and as a domino effect, > their > + bus-specific counterparts) will be made opaque in DPDK 22.11. > + Registering a driver on a bus will be marked as an internal API: > + external users may still register their drivers using the bus specific > + driver header (see ``enable_driver_sdk`` meson option). > + Cc SPDK folks Thanks for your work! My only concern is using enable_driver_sdk may not be a good way for SPDK based on the discussion. http://patchwork.dpdk.org/project/dpdk/cover/20210918022443.12719-1-chenbo.= xia@intel.com/ But overall this idea makes sense, so: Acked-by: Chenbo Xia > * mempool: Helper macro ``MEMPOOL_HEADER_SIZE()`` is deprecated and will > be removed in DPDK 22.11. The replacement macro > ``RTE_MEMPOOL_HEADER_SIZE()`` is internal only. > @@ -49,11 +56,6 @@ Deprecation Notices > * mempool: The mempool API macros ``MEMPOOL_PG_*`` are deprecated and > will be removed in DPDK 22.11. >=20 > -* pci: To reduce unnecessary ABIs exposed by DPDK bus driver, > "rte_bus_pci.h" > - will be made internal in 21.11 and macros/data structures/functions > defined > - in the header will not be considered as ABI anymore. This change is > inspired > - by the RFC https://patchwork.dpdk.org/project/dpdk/list/?series=3D1717= 6. > - > * lib: will fix extending some enum/define breaking the ABI. There are > multiple > samples in DPDK that enum/define terminated with a ``.*MAX.*`` value > which is > used by iterators, and arrays holding these values are sized with this > -- > 2.36.1