[dpdk-dev,v2] doc: add deprecation notice for memory hotplug changes

Message ID 32a6f11b2e6bc88c90ef39cb0494b8c3335a94d7.1516270352.git.anatoly.burakov@intel.com (mailing list archive)
State Accepted, archived
Delegated to: Thomas Monjalon
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation fail Compilation issues

Commit Message

Anatoly Burakov Jan. 18, 2018, 10:32 a.m. UTC
  Due to coming changes outlined in memory hotplug RFC, there will
be several API/ABI changes.

Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
---

Notes:
    Patch outlining future changes:
    http://dpdk.org/dev/patchwork/patch/32467/
    
    v2: added rte_mem_config and rte_memzone changes to the announcement

 doc/guides/rel_notes/deprecation.rst | 9 +++++++++
 1 file changed, 9 insertions(+)
  

Comments

John McNamara Jan. 23, 2018, 10:36 a.m. UTC | #1
> -----Original Message-----
> From: Burakov, Anatoly
> Sent: Thursday, January 18, 2018 10:32 AM
> To: dev@dpdk.org
> Cc: Neil Horman <nhorman@tuxdriver.com>; Mcnamara, John
> <john.mcnamara@intel.com>; Kovacevic, Marko <marko.kovacevic@intel.com>
> Subject: [PATCH v2] doc: add deprecation notice for memory hotplug changes
> 
> Due to coming changes outlined in memory hotplug RFC, there will be
> several API/ABI changes.
> 
> Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>

Acked-by: John McNamara <john.mcnamara@intel.com>
  
Bruce Richardson Feb. 5, 2018, 11:47 a.m. UTC | #2
On Thu, Jan 18, 2018 at 10:32:28AM +0000, Anatoly Burakov wrote:
> Due to coming changes outlined in memory hotplug RFC, there will
> be several API/ABI changes.
> 
> Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> ---
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
  
Jerin Jacob Feb. 7, 2018, 10:11 a.m. UTC | #3
-----Original Message-----
> Date: Mon, 5 Feb 2018 11:47:42 +0000
> From: Bruce Richardson <bruce.richardson@intel.com>
> To: Anatoly Burakov <anatoly.burakov@intel.com>
> CC: dev@dpdk.org, Neil Horman <nhorman@tuxdriver.com>, John McNamara
>  <john.mcnamara@intel.com>, Marko Kovacevic <marko.kovacevic@intel.com>
> Subject: Re: [dpdk-dev] [PATCH v2] doc: add deprecation notice for memory
>  hotplug changes
> User-Agent: Mutt/1.9.1 (2017-09-22)
> 
> On Thu, Jan 18, 2018 at 10:32:28AM +0000, Anatoly Burakov wrote:
> > Due to coming changes outlined in memory hotplug RFC, there will
> > be several API/ABI changes.
> > 
> > Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> > ---
> Acked-by: Bruce Richardson <bruce.richardson@intel.com>

Acked-by: Jerin Jacob <jerin.jacob@caviumnetworks.com>

>
  
Jonas Pfefferle Feb. 12, 2018, 3:58 p.m. UTC | #4
On Thu, 18 Jan 2018 10:32:28 +0000
  Anatoly Burakov <anatoly.burakov@intel.com> wrote:
> Due to coming changes outlined in memory hotplug RFC, there will
> be several API/ABI changes.
> 
> Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> ---
> 
> Notes:
>    Patch outlining future changes:
>    http://dpdk.org/dev/patchwork/patch/32467/
>    
>    v2: added rte_mem_config and rte_memzone changes to the 
>announcement
> 
> doc/guides/rel_notes/deprecation.rst | 9 +++++++++
> 1 file changed, 9 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst 
>b/doc/guides/rel_notes/deprecation.rst
> index 13e8543..93cbeea 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -8,6 +8,15 @@ API and ABI deprecation notices are to be posted 
>here.
> Deprecation Notices
> -------------------
> 
> +* eal: due to internal data layoyut reorganization, there will be 
>changes to
> +  several structures and functions as a result of coming changes to 
>support
> +  memory hotplug in v18.05.
> +  ``rte_eal_get_physmem_layout`` will be deprecated and removed in 
>subsequent
> +  releases.
> +  ``rte_mem_config`` contents will change due to switch to memseg 
>lists.
> +  ``rte_memzone`` member ``memseg_id`` will no longer serve any 
>useful purpose
> +  and will be removed.
> +
> * eal: several API and ABI changes are planned for ``rte_devargs`` 
>in v18.02.
>   The format of device command line parameters will change. The bus 
>will need
>   to be explicitly stated in the device declaration. The enum 
>``rte_devtype``
> -- 
> 2.7.4

Acked-by: Jonas Pfefferle <pepperjo@japf.ch>
  
Yongseok Koh Feb. 13, 2018, 12:24 a.m. UTC | #5
> On Jan 18, 2018, at 2:32 AM, Anatoly Burakov <anatoly.burakov@intel.com> wrote:
> 
> Due to coming changes outlined in memory hotplug RFC, there will
> be several API/ABI changes.
> 
> Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> ---
Acked-by: Yongseok Koh <yskoh@mellanox.com>
 
Thanks
  
Thomas Monjalon Feb. 14, 2018, 2:48 p.m. UTC | #6
07/02/2018 11:11, Jerin Jacob:
> -----Original Message-----
> > Date: Mon, 5 Feb 2018 11:47:42 +0000
> > From: Bruce Richardson <bruce.richardson@intel.com>
> > To: Anatoly Burakov <anatoly.burakov@intel.com>
> > CC: dev@dpdk.org, Neil Horman <nhorman@tuxdriver.com>, John McNamara
> >  <john.mcnamara@intel.com>, Marko Kovacevic <marko.kovacevic@intel.com>
> > Subject: Re: [dpdk-dev] [PATCH v2] doc: add deprecation notice for memory
> >  hotplug changes
> > User-Agent: Mutt/1.9.1 (2017-09-22)
> > 
> > On Thu, Jan 18, 2018 at 10:32:28AM +0000, Anatoly Burakov wrote:
> > > Due to coming changes outlined in memory hotplug RFC, there will
> > > be several API/ABI changes.
> > > 
> > > Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> > > ---
> > Acked-by: Bruce Richardson <bruce.richardson@intel.com>
> 
> Acked-by: Jerin Jacob <jerin.jacob@caviumnetworks.com>

Applied
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 13e8543..93cbeea 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -8,6 +8,15 @@  API and ABI deprecation notices are to be posted here.
 Deprecation Notices
 -------------------
 
+* eal: due to internal data layoyut reorganization, there will be changes to
+  several structures and functions as a result of coming changes to support
+  memory hotplug in v18.05.
+  ``rte_eal_get_physmem_layout`` will be deprecated and removed in subsequent
+  releases.
+  ``rte_mem_config`` contents will change due to switch to memseg lists.
+  ``rte_memzone`` member ``memseg_id`` will no longer serve any useful purpose
+  and will be removed.
+
 * eal: several API and ABI changes are planned for ``rte_devargs`` in v18.02.
   The format of device command line parameters will change. The bus will need
   to be explicitly stated in the device declaration. The enum ``rte_devtype``