Skip to contentSkip to conversation

lib/power: remove set env deprecation notice

PATCH Superseded David Hunt 2 participants 6 messages Oct 27, 2020 – Nov 4, 2020

lore
Share & tools
lore

David Hunt

author
#0 lore raw

PATCH v2 1/1 lib/power: remove set env deprecation notice

Remove notice announcing an already-implemented change.

In 19.05, rte_power_set_env was changed to return -1 in cases where the envorinment was already set up, and for the same release, a deprecation notice was added for the following commit:
'commit 5a5f3178d4a8 ("power: return error when environment already set")' This patch removes that notice.

The API change was tested by calling rte_power_set_env twice. The first call succeeded, and the second call failed, as expected.

---
 doc/guides/rel_notes/deprecation.rst | 5 -----
 1 file changed, 5 deletions(-)
doc/guides/rel_notes/deprecation.rst +0 -5
index 76a83968c..ed82df52a 100644
@@ -172,11 +172,6 @@ Deprecation Notices
 * metrics: The function ``rte_metrics_init`` will have a non-void return
   in order to notify errors instead of calling ``rte_exit``.
 
-* power: ``rte_power_set_env`` function will no longer return 0 on attempt
-  to set new power environment if power environment was already initialized.
-  In this case the function will return -1 unless the environment is unset first
-  (using ``rte_power_unset_env``). Other function usage scenarios will not change.
-
 * cmdline: ``cmdline`` structure will be made opaque to hide platform-specific
   content. On Linux and FreeBSD, supported prior to DPDK 20.11,
   original structure will be kept until DPDK 21.11.
Signature · 1 line
2.17.1
author
#1 lore raw

PATCH v3 1/1 lib/power: remove set env deprecation notice

Remove notice announcing an already-implemented change.

In 19.05, rte_power_set_env was changed to return -1 in cases where the envorinment was already set up, and for the same release, a deprecation notice was added for the following commit:
'commit 5a5f3178d4a8 ("power: return error when environment already set")' This patch removes that notice.

The API change was tested by calling rte_power_set_env twice. The first call succeeded, and the second call failed, as expected.

---
 doc/guides/rel_notes/deprecation.rst | 5 -----
 1 file changed, 5 deletions(-)
doc/guides/rel_notes/deprecation.rst +0 -5
index 76a83968c..ed82df52a 100644
@@ -172,11 +172,6 @@ Deprecation Notices
 * metrics: The function ``rte_metrics_init`` will have a non-void return
   in order to notify errors instead of calling ``rte_exit``.
 
-* power: ``rte_power_set_env`` function will no longer return 0 on attempt
-  to set new power environment if power environment was already initialized.
-  In this case the function will return -1 unless the environment is unset first
-  (using ``rte_power_unset_env``). Other function usage scenarios will not change.
-
 * cmdline: ``cmdline`` structure will be made opaque to hide platform-specific
   content. On Linux and FreeBSD, supported prior to DPDK 20.11,
   original structure will be kept until DPDK 21.11.
Signature · 1 line
2.17.1
author
#2 lore raw

PATCH v4 1/1 lib/power: remove set env deprecation notice

Remove notice announcing an already-implemented change.

In 19.05, rte_power_set_env was changed to return -1 in cases where the envorinment was already set up, and for the same release, a deprecation notice was added for the following commit:
'commit 5a5f3178d4a8 ("power: return error when environment already set")' This patch removes that notice.

The API change was tested by calling rte_power_set_env twice. The first call succeeded, and the second call failed, as expected.

---

v1 initial version (with typo in the title)
v2 fix typo but forgot --in-reply-to
v3 add -in-reply-to
v4 add in version info, and cc stable in case it needs to be backported

Note: CC'ing stable in case the deprecation notice should also be removed from 19.11. It looks to me like the patch making the change and the patch adding the notice were both added in 19.11, so the notice is no longer needed in that verion. I didn't add a Fixes line to this patch as I believe the notice was correct, just adding both fix and notice in the same version was not strictly the right thing to have done at the time.

---
 doc/guides/rel_notes/deprecation.rst | 5 -----
 1 file changed, 5 deletions(-)
doc/guides/rel_notes/deprecation.rst +0 -5
index 76a83968c..ed82df52a 100644
@@ -172,11 +172,6 @@ Deprecation Notices
 * metrics: The function ``rte_metrics_init`` will have a non-void return
   in order to notify errors instead of calling ``rte_exit``.
 
-* power: ``rte_power_set_env`` function will no longer return 0 on attempt
-  to set new power environment if power environment was already initialized.
-  In this case the function will return -1 unless the environment is unset first
-  (using ``rte_power_unset_env``). Other function usage scenarios will not change.
-
 * cmdline: ``cmdline`` structure will be made opaque to hide platform-specific
   content. On Linux and FreeBSD, supported prior to DPDK 20.11,
   original structure will be kept until DPDK 21.11.
Signature · 1 line
2.17.1
#3 lore raw

27/10/2020 14:24, David Hunt:

Quoted 20 lines

Remove notice announcing an already-implemented change.

In 19.05, rte_power_set_env was changed to return -1 in cases where the envorinment was already set up, and for the same release, a deprecation notice was added for the following commit:
'commit 5a5f3178d4a8 ("power: return error when environment already set")' This patch removes that notice.

The API change was tested by calling rte_power_set_env twice. The first call succeeded, and the second call failed, as expected.

---

v1 initial version (with typo in the title)
v2 fix typo but forgot --in-reply-to
v3 add -in-reply-to
v4 add in version info, and cc stable in case it needs to be backported

Quoted 6 lines

Note: CC'ing stable in case the deprecation notice should also be removed from 19.11. It looks to me like the patch making the change and the patch adding the notice were both added in 19.11, so the notice is no longer needed in that verion. I didn't add a Fixes line to this patch as I believe the notice was correct, just adding both fix and notice in the same version was not strictly the right thing to have done at the time.

The Fixes: line must reference the commit which did the API change without removing the notice.

Cc [email protected] must be below the Fixes line.
author
#4 lore raw

PATCH v5 1/1 lib/power: remove set env deprecation notice

In reply to David Hunt

Remove notice announcing an already-implemented change.

In 19.05, rte_power_set_env was changed to return -1 in cases where the envorinment was already set up, and for the same release, a deprecation notice was added for the following commit:
'commit 5a5f3178d4a8 ("power: return error when environment already set")' This patch removes that notice.

The API change was tested by calling rte_power_set_env twice. The first call succeeded, and the second call failed, as expected.

Fixes 5a5f3178d4a8 ("power: return error when environment already set")

---
v1 initial version (with typo in the title)
v2 fix typo but forgot --in-reply-to
v3 add -in-reply-to
v4 add in version info, and cc stable in case it needs to be backported v5 add in Fixes line.

Note: CC'ing stable in case the deprecation notice should also be removed from 19.11. It looks to me like the patch making the change and the patch adding the notice were both added in 19.11, so the notice is no longer needed in that version.
---

---
 doc/guides/rel_notes/deprecation.rst | 5 -----
 1 file changed, 5 deletions(-)
doc/guides/rel_notes/deprecation.rst +0 -5
index 43e0e09be..7e40f2d72 100644
@@ -141,11 +141,6 @@ Deprecation Notices
 * metrics: The function ``rte_metrics_init`` will have a non-void return
   in order to notify errors instead of calling ``rte_exit``.
 
-* power: ``rte_power_set_env`` function will no longer return 0 on attempt
-  to set new power environment if power environment was already initialized.
-  In this case the function will return -1 unless the environment is unset first
-  (using ``rte_power_unset_env``). Other function usage scenarios will not change.
-
 * cmdline: ``cmdline`` structure will be made opaque to hide platform-specific
   content. On Linux and FreeBSD, supported prior to DPDK 20.11,
   original structure will be kept until DPDK 21.11.
Signature · 1 line
2.17.1
#5 lore raw

04/11/2020 10:28, David Hunt:

Quoted 8 lines

Remove notice announcing an already-implemented change.

In 19.05, rte_power_set_env was changed to return -1 in cases where the envorinment was already set up, and for the same release, a deprecation notice was added for the following commit:
'commit 5a5f3178d4a8 ("power: return error when environment already set")' This patch removes that notice.

Quoted 6 lines

The API change was tested by calling rte_power_set_env twice. The first call succeeded, and the second call failed, as expected.

Fixes 5a5f3178d4a8 ("power: return error when environment already set")

Re-arranged, title reworded and applied, thanks