[dpdk-dev] doc: announce API and ABI changes for librte_eal

Message ID 1478776678-16328-1-git-send-email-shreyansh.jain@nxp.com (mailing list archive)
State Accepted, archived
Headers

Commit Message

Shreyansh Jain Nov. 10, 2016, 11:17 a.m. UTC
  Signed-off-by: Shreyansh Jain <shreyansh.jain@nxp.com>
---
 doc/guides/rel_notes/deprecation.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)
  

Comments

David Marchand Nov. 10, 2016, 3:51 p.m. UTC | #1
On Thu, Nov 10, 2016 at 12:17 PM, Shreyansh Jain <shreyansh.jain@nxp.com> wrote:
> Signed-off-by: Shreyansh Jain <shreyansh.jain@nxp.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 10 ++++++++++
>  1 file changed, 10 insertions(+)
>
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index 1a9e1ae..2af2476 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -35,3 +35,13 @@ Deprecation Notices
>  * mempool: The functions for single/multi producer/consumer are deprecated
>    and will be removed in 17.02.
>    It is replaced by ``rte_mempool_generic_get/put`` functions.
> +
> +* ABI/API changes are planned for 17.02: ``rte_device``, ``rte_driver`` will be
> +  impacted because of introduction of a new ``rte_bus`` hierarchy. This would
> +  also impact the way devices are identified by EAL. A bus-device-driver model
> +  will be introduced providing a hierarchical view of devices.
> +
> +* ``eth_driver`` is planned to be removed in 17.02. This currently serves as
> +  a placeholder for PMDs to register themselves. Changes for ``rte_bus`` will
> +  provide a way to handle device initialization currently being done in
> +  ``eth_driver``.
> --
> 2.7.4
>

Acked-by: David Marchand <david.marchand@6wind.com>
  
Ferruh Yigit Nov. 11, 2016, 1:05 p.m. UTC | #2
On 11/10/2016 3:51 PM, David Marchand wrote:
> On Thu, Nov 10, 2016 at 12:17 PM, Shreyansh Jain <shreyansh.jain@nxp.com> wrote:
>> Signed-off-by: Shreyansh Jain <shreyansh.jain@nxp.com>
>> ---
>>  doc/guides/rel_notes/deprecation.rst | 10 ++++++++++
>>  1 file changed, 10 insertions(+)
>>
>> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
>> index 1a9e1ae..2af2476 100644
>> --- a/doc/guides/rel_notes/deprecation.rst
>> +++ b/doc/guides/rel_notes/deprecation.rst
>> @@ -35,3 +35,13 @@ Deprecation Notices
>>  * mempool: The functions for single/multi producer/consumer are deprecated
>>    and will be removed in 17.02.
>>    It is replaced by ``rte_mempool_generic_get/put`` functions.
>> +
>> +* ABI/API changes are planned for 17.02: ``rte_device``, ``rte_driver`` will be
>> +  impacted because of introduction of a new ``rte_bus`` hierarchy. This would
>> +  also impact the way devices are identified by EAL. A bus-device-driver model
>> +  will be introduced providing a hierarchical view of devices.
>> +
>> +* ``eth_driver`` is planned to be removed in 17.02. This currently serves as
>> +  a placeholder for PMDs to register themselves. Changes for ``rte_bus`` will
>> +  provide a way to handle device initialization currently being done in
>> +  ``eth_driver``.
>> --
>> 2.7.4
>>
> 
> Acked-by: David Marchand <david.marchand@6wind.com>

Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>
  
Pattan, Reshma Nov. 11, 2016, 3:02 p.m. UTC | #3
> -----Original Message-----

> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Ferruh Yigit

> Sent: Friday, November 11, 2016 1:05 PM

> To: David Marchand <david.marchand@6wind.com>; Shreyansh Jain

> <shreyansh.jain@nxp.com>

> Cc: Neil Horman <nhorman@tuxdriver.com>; dev@dpdk.org; Thomas

> Monjalon <thomas.monjalon@6wind.com>

> Subject: Re: [dpdk-dev] [PATCH] doc: announce API and ABI changes for

> librte_eal

> 

> On 11/10/2016 3:51 PM, David Marchand wrote:

> > On Thu, Nov 10, 2016 at 12:17 PM, Shreyansh Jain

> <shreyansh.jain@nxp.com> wrote:

> >> Signed-off-by: Shreyansh Jain <shreyansh.jain@nxp.com>

> >> ---

> >>  doc/guides/rel_notes/deprecation.rst | 10 ++++++++++

> >>  1 file changed, 10 insertions(+)

> >>

> >> diff --git a/doc/guides/rel_notes/deprecation.rst

> b/doc/guides/rel_notes/deprecation.rst

> >> index 1a9e1ae..2af2476 100644

> >> --- a/doc/guides/rel_notes/deprecation.rst

> >> +++ b/doc/guides/rel_notes/deprecation.rst

> >> @@ -35,3 +35,13 @@ Deprecation Notices

> >>  * mempool: The functions for single/multi producer/consumer are

> deprecated

> >>    and will be removed in 17.02.

> >>    It is replaced by ``rte_mempool_generic_get/put`` functions.

> >> +

> >> +* ABI/API changes are planned for 17.02: ``rte_device``, ``rte_driver`` will

> be

> >> +  impacted because of introduction of a new ``rte_bus`` hierarchy. This

> would

> >> +  also impact the way devices are identified by EAL. A bus-device-driver

> model

> >> +  will be introduced providing a hierarchical view of devices.

> >> +

> >> +* ``eth_driver`` is planned to be removed in 17.02. This currently serves

> as

> >> +  a placeholder for PMDs to register themselves. Changes for ``rte_bus``

> will

> >> +  provide a way to handle device initialization currently being done in

> >> +  ``eth_driver``.

> >> --

> >> 2.7.4

> >>

> >

> > Acked-by: David Marchand <david.marchand@6wind.com>

> 

> Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>


Acked-by: Reshma Pattan <reshma.pattan@intel.com>
  
Thomas Monjalon Nov. 13, 2016, 9:02 a.m. UTC | #4
> > >> Signed-off-by: Shreyansh Jain <shreyansh.jain@nxp.com>
> > >
> > > Acked-by: David Marchand <david.marchand@6wind.com>
> > 
> > Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>
> 
> Acked-by: Reshma Pattan <reshma.pattan@intel.com>

Applied
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 1a9e1ae..2af2476 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -35,3 +35,13 @@  Deprecation Notices
 * mempool: The functions for single/multi producer/consumer are deprecated
   and will be removed in 17.02.
   It is replaced by ``rte_mempool_generic_get/put`` functions.
+
+* ABI/API changes are planned for 17.02: ``rte_device``, ``rte_driver`` will be
+  impacted because of introduction of a new ``rte_bus`` hierarchy. This would
+  also impact the way devices are identified by EAL. A bus-device-driver model
+  will be introduced providing a hierarchical view of devices.
+
+* ``eth_driver`` is planned to be removed in 17.02. This currently serves as
+  a placeholder for PMDs to register themselves. Changes for ``rte_bus`` will
+  provide a way to handle device initialization currently being done in
+  ``eth_driver``.