Message ID | 1460043197-13707-1-git-send-email-david.marchand@6wind.com (mailing list archive) |
---|---|
State | Accepted, archived |
Headers |
Return-Path: <dev-bounces@dpdk.org> X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 9BE1A2BD9; Thu, 7 Apr 2016 17:33:23 +0200 (CEST) Received: from mail-wm0-f49.google.com (mail-wm0-f49.google.com [74.125.82.49]) by dpdk.org (Postfix) with ESMTP id 94F252BCE for <dev@dpdk.org>; Thu, 7 Apr 2016 17:33:22 +0200 (CEST) Received: by mail-wm0-f49.google.com with SMTP id v188so60680743wme.1 for <dev@dpdk.org>; Thu, 07 Apr 2016 08:33:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id; bh=H9UEHWqM/jGXjgtWQmafGpWPogQm1rEwy98TjjL1t+8=; b=UE5D8f4RKuw54QGSexbXFE3hkeHiFkGLVBDufPbgC4L3nPXYdqFoeSdxD364l0zKMO zFxlUF3WG7tEz3Bm3YXuMkfyhRBUYjqcYdnt9e7v1CoFGLfQoIw1lQS54yT9b7HKZZPq yvRyp/vCQ5l0wEafj9I+3K5EBYuZvvC7BovpxUuQQX3BS+PNDK8qsfp+7W/KREjl3raT LrzuDjlGe3zVzTq7UJMum0u0tH/iMr911Qxdb/0xB//pNVjoK3CWSPinJN/qe1/ejypI DNBW4lyY5NpEbzLRysiB9207s8XXddnYX334rej9czUCgOSe4eHG0/LnHwupr47GpCx0 j2LA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=H9UEHWqM/jGXjgtWQmafGpWPogQm1rEwy98TjjL1t+8=; b=UnEzVTdhCLbbrj4vy+28g0SOVdc1n4SiP1bcMo9stVE3YMCKAolykcCd0gYGtiCkER TYFU9zWS7t/n1coCo4/0W0lrYX0aSu0cOU/jDw7EobM63n1FE6+93N38WXMW0DymJzzt JF4sLzLMiLXYgaNMebyQ3fIBX95BC94t7bGYEO6xq9etrBCTFQc0wCv/iNRfX/Ju/qmQ ewvczd0Lf9XkIjOY5GhclMOI31Y9yEq0na8YxqYD4+34xqpRoKk6jFdNvLTx4fbtTGYv 3u825e80kPI/nIVaIlCc5U/n8SDZcfOM/+rQ309NsmzSQhAeTznLtRuaPPqIuiQ9ZSgX lcSg== X-Gm-Message-State: AD7BkJKb+Wo6ADZ68+W+rr7ugMGpDUIbIRqai5GIk0B+xZEMx5RsW4zif9fOpXIlWR+olYf5 X-Received: by 10.194.63.8 with SMTP id c8mr2210026wjs.89.1460043202369; Thu, 07 Apr 2016 08:33:22 -0700 (PDT) Received: from gloops.dev.6wind.com (144.77.126.78.rev.sfr.net. [78.126.77.144]) by smtp.gmail.com with ESMTPSA id z6sm9449644wme.9.2016.04.07.08.33.21 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 07 Apr 2016 08:33:21 -0700 (PDT) From: David Marchand <david.marchand@6wind.com> To: dev@dpdk.org Cc: viktorin@rehivetech.com, olivier.matz@6wind.com, thomas.monjalon@6wind.com Date: Thu, 7 Apr 2016 17:33:17 +0200 Message-Id: <1460043197-13707-1-git-send-email-david.marchand@6wind.com> X-Mailer: git-send-email 1.9.1 Subject: [dpdk-dev] [PATCH] doc: announce API changes for device objects X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK <dev.dpdk.org> List-Unsubscribe: <http://dpdk.org/ml/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://dpdk.org/ml/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <http://dpdk.org/ml/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org Sender: "dev" <dev-bounces@dpdk.org> |
Commit Message
David Marchand
April 7, 2016, 3:33 p.m. UTC
Following discussions with Jan, here is a deprecation notice to prepare for
hotplug and rte_device changes to come in 16.07.
Signed-off-by: David Marchand <david.marchand@6wind.com>
---
doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
1 file changed, 12 insertions(+)
Comments
On Thu, 7 Apr 2016 17:33:17 +0200 David Marchand <david.marchand@6wind.com> wrote: > Following discussions with Jan, here is a deprecation notice to prepare for > hotplug and rte_device changes to come in 16.07. > > Signed-off-by: David Marchand <david.marchand@6wind.com> > --- > doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++ > 1 file changed, 12 insertions(+) > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index 98d5529..d749e5d 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -8,6 +8,18 @@ API and ABI deprecation notices are to be posted here. > Deprecation Notices > ------------------- > > +* The ethdev hotplug API is going to be moved to EAL with a notification > + mechanism added to crypto and ethdev libraries so that hotplug is now > + available to both of them. This API will be stripped of the device arguments > + so that it only cares about hotplugging. > + > +* Structures embodying pci and vdev devices are going to be reworked to > + integrate new common rte_device / rte_driver objects (see > + http://dpdk.org/ml/archives/dev/2016-January/031390.html). > + ethdev and crypto libraries will then only handle those objects so that they > + do not need to care about the kind of devices that are being used, making it > + easier to add new buses later. As a result, the current rte_driver structure will be renamed to rte_module and probably reworked in some way due to its semantics and potential name clash with the new rte_driver struct. Regards Jan > + > * The EAL function pci_config_space_set is deprecated in release 16.04 > and will be removed from 16.07. > Macros CONFIG_RTE_PCI_CONFIG, CONFIG_RTE_PCI_EXTENDED_TAG and
On Thu, Apr 7, 2016 at 5:46 PM, Jan Viktorin <viktorin@rehivetech.com> wrote: > On Thu, 7 Apr 2016 17:33:17 +0200 > David Marchand <david.marchand@6wind.com> wrote: > >> Following discussions with Jan, here is a deprecation notice to prepare for >> hotplug and rte_device changes to come in 16.07. >> >> Signed-off-by: David Marchand <david.marchand@6wind.com> >> --- >> doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++ >> 1 file changed, 12 insertions(+) >> >> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst >> index 98d5529..d749e5d 100644 >> --- a/doc/guides/rel_notes/deprecation.rst >> +++ b/doc/guides/rel_notes/deprecation.rst >> @@ -8,6 +8,18 @@ API and ABI deprecation notices are to be posted here. >> Deprecation Notices >> ------------------- >> >> +* The ethdev hotplug API is going to be moved to EAL with a notification >> + mechanism added to crypto and ethdev libraries so that hotplug is now >> + available to both of them. This API will be stripped of the device arguments >> + so that it only cares about hotplugging. >> + >> +* Structures embodying pci and vdev devices are going to be reworked to >> + integrate new common rte_device / rte_driver objects (see >> + http://dpdk.org/ml/archives/dev/2016-January/031390.html). >> + ethdev and crypto libraries will then only handle those objects so that they >> + do not need to care about the kind of devices that are being used, making it >> + easier to add new buses later. > > As a result, the current rte_driver structure will be renamed to > rte_module and probably reworked in some way due to its semantics and > potential name clash with the new rte_driver struct. If we just introduce some macros like RTE_MODULE_INIT() / RTE_MODULE_EXIT(), we don't need a rte_module object at the moment ?
On Thu, 7 Apr 2016 19:00:43 +0200 David Marchand <david.marchand@6wind.com> wrote: > On Thu, Apr 7, 2016 at 5:46 PM, Jan Viktorin <viktorin@rehivetech.com> wrote: > > On Thu, 7 Apr 2016 17:33:17 +0200 > > David Marchand <david.marchand@6wind.com> wrote: > > > >> Following discussions with Jan, here is a deprecation notice to prepare for > >> hotplug and rte_device changes to come in 16.07. > >> > >> Signed-off-by: David Marchand <david.marchand@6wind.com> > >> --- > >> doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++ > >> 1 file changed, 12 insertions(+) > >> > >> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > >> index 98d5529..d749e5d 100644 > >> --- a/doc/guides/rel_notes/deprecation.rst > >> +++ b/doc/guides/rel_notes/deprecation.rst > >> @@ -8,6 +8,18 @@ API and ABI deprecation notices are to be posted here. > >> Deprecation Notices > >> ------------------- > >> > >> +* The ethdev hotplug API is going to be moved to EAL with a notification > >> + mechanism added to crypto and ethdev libraries so that hotplug is now > >> + available to both of them. This API will be stripped of the device arguments > >> + so that it only cares about hotplugging. > >> + > >> +* Structures embodying pci and vdev devices are going to be reworked to > >> + integrate new common rte_device / rte_driver objects (see > >> + http://dpdk.org/ml/archives/dev/2016-January/031390.html). > >> + ethdev and crypto libraries will then only handle those objects so that they > >> + do not need to care about the kind of devices that are being used, making it > >> + easier to add new buses later. > > > > As a result, the current rte_driver structure will be renamed to > > rte_module and probably reworked in some way due to its semantics and > > potential name clash with the new rte_driver struct. > > If we just introduce some macros like RTE_MODULE_INIT() / > RTE_MODULE_EXIT(), we don't need a rte_module object at the moment ? > Well, possibly, we don't need it. At least, it might be hidden and not being a part of the API/ABI. Do you need an ack for this?
On Thu, Apr 7, 2016 at 7:09 PM, Jan Viktorin <viktorin@rehivetech.com> wrote: > On Thu, 7 Apr 2016 19:00:43 +0200 > David Marchand <david.marchand@6wind.com> wrote: >> >> Following discussions with Jan, here is a deprecation notice to prepare for >> >> hotplug and rte_device changes to come in 16.07. >> > As a result, the current rte_driver structure will be renamed to >> > rte_module and probably reworked in some way due to its semantics and >> > potential name clash with the new rte_driver struct. >> >> If we just introduce some macros like RTE_MODULE_INIT() / >> RTE_MODULE_EXIT(), we don't need a rte_module object at the moment ? >> > > Well, possibly, we don't need it. At least, it might be hidden and not > being a part of the API/ABI. Do you need an ack for this? Yes, please, the process requires 3 acks for this kind of changes.
On Thu, 7 Apr 2016 17:33:17 +0200 David Marchand <david.marchand@6wind.com> wrote: > Following discussions with Jan, here is a deprecation notice to prepare for > hotplug and rte_device changes to come in 16.07. > > Signed-off-by: David Marchand <david.marchand@6wind.com> > --- Acked-by: Jan Viktorin <viktorin@rehivetech.com>
On 04/07/2016 07:27 PM, Jan Viktorin wrote: > On Thu, 7 Apr 2016 17:33:17 +0200 > David Marchand <david.marchand@6wind.com> wrote: > >> Following discussions with Jan, here is a deprecation notice to prepare for >> hotplug and rte_device changes to come in 16.07. >> >> Signed-off-by: David Marchand <david.marchand@6wind.com> >> --- > Acked-by: Jan Viktorin <viktorin@rehivetech.com> > Acked-by: Olivier Matz <olivier.matz@6wind.com>
2016-04-08 11:35, Olivier Matz: > On 04/07/2016 07:27 PM, Jan Viktorin wrote: > > On Thu, 7 Apr 2016 17:33:17 +0200 > > David Marchand <david.marchand@6wind.com> wrote: > > > >> Following discussions with Jan, here is a deprecation notice to prepare for > >> hotplug and rte_device changes to come in 16.07. > >> > >> Signed-off-by: David Marchand <david.marchand@6wind.com> > >> --- > > Acked-by: Jan Viktorin <viktorin@rehivetech.com> > > Acked-by: Olivier Matz <olivier.matz@6wind.com> Acked-by: Thomas Monjalon <thomas.monjalon@6wind.com>
> > >> Following discussions with Jan, here is a deprecation notice to prepare for > > >> hotplug and rte_device changes to come in 16.07. > > >> > > >> Signed-off-by: David Marchand <david.marchand@6wind.com> > > >> --- > > > Acked-by: Jan Viktorin <viktorin@rehivetech.com> > > > > Acked-by: Olivier Matz <olivier.matz@6wind.com> > > Acked-by: Thomas Monjalon <thomas.monjalon@6wind.com> Applied, thanks
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 98d5529..d749e5d 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -8,6 +8,18 @@ API and ABI deprecation notices are to be posted here. Deprecation Notices ------------------- +* The ethdev hotplug API is going to be moved to EAL with a notification + mechanism added to crypto and ethdev libraries so that hotplug is now + available to both of them. This API will be stripped of the device arguments + so that it only cares about hotplugging. + +* Structures embodying pci and vdev devices are going to be reworked to + integrate new common rte_device / rte_driver objects (see + http://dpdk.org/ml/archives/dev/2016-January/031390.html). + ethdev and crypto libraries will then only handle those objects so that they + do not need to care about the kind of devices that are being used, making it + easier to add new buses later. + * The EAL function pci_config_space_set is deprecated in release 16.04 and will be removed from 16.07. Macros CONFIG_RTE_PCI_CONFIG, CONFIG_RTE_PCI_EXTENDED_TAG and