doc: announce changes to eventdev public data structures

Message ID 1596221511-23552-1-git-send-email-timothy.mcdaniel@intel.com (mailing list archive)
State Superseded, archived
Headers
Series doc: announce changes to eventdev public data structures |

Checks

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

Commit Message

Timothy McDaniel July 31, 2020, 6:51 p.m. UTC
  From: "McDaniel, Timothy" <timothy.mcdaniel@intel.com>

Signed-off-by: McDaniel, Timothy <timothy.mcdaniel@intel.com>
---
 doc/guides/rel_notes/deprecation.rst |   37 +++++++++-------------------------
 1 file changed, 10 insertions(+), 27 deletions(-)
  

Comments

Jerin Jacob July 31, 2020, 7:03 p.m. UTC | #1
On Sat, Aug 1, 2020 at 12:24 AM McDaniel, Timothy
<timothy.mcdaniel@intel.com> wrote:
>
> From: "McDaniel, Timothy" <timothy.mcdaniel@intel.com>
>
> Signed-off-by: McDaniel, Timothy <timothy.mcdaniel@intel.com>
> ---
>  doc/guides/rel_notes/deprecation.rst |   37 +++++++++-------------------------
>  1 file changed, 10 insertions(+), 27 deletions(-)
>
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index ecb1bc4..4809643 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -149,30 +149,13 @@ Deprecation Notices
>    In 20.08, explicit deprecation warnings will be displayed when running
>    scripts with Python 2.
>
> -* eventdev: Three public data structures will be updated in 20.11;
> -  ``rte_event_dev_info``, ``rte_event_dev_config``, and
> -  ``rte_event_port_conf``.
> -  Two new members will be added to the ``rte_event_dev_info`` struct.
> -  The first, max_event_port_links, will be a uint8_t, and represents the
> -  maximum number of queues that can be linked to a single event port by
> -  this device. The second, max_single_link_event_port_queue_pairs, will be a
> -  uint8_t, and represents the maximum number of event ports and queues that
> -  are optimized for (and only capable of) single-link configurations
> -  supported by this device. These ports and queues are not accounted for in
> -  max_event_ports or max_event_queues.
> -  One new member will be added to the ``rte_event_dev_config`` struct. The
> -  nb_single_link_event_port_queues member will be a uint8_t, and will
> -  represent the number of event ports and queues that will be singly-linked
> -  to each other. These are a subset of the overall event ports and queues.
> -  This value cannot exceed nb_event_ports or nb_event_queues. If the
> -  device has ports and queues that are optimized for single-link usage, this
> -  field is a hint for how many to allocate; otherwise, regular event ports and
> -  queues can be used.
> -  Finally, the ``rte_event_port_conf`` struct will be
> -  modified as follows. The uint8_t implicit_release_disabled field
> -  will be replaced by a uint32_t event_port_cfg field. The new field will
> -  initially have two bits assigned. RTE_EVENT_PORT_CFG_DISABLE_IMPL_REL
> -  will have the same meaning as implicit_release_disabled. The second bit,
> -  RTE_EVENT_PORT_CFG_SINGLE_LINK will be set if the event port links only
> -  to a single event queue.

Remove this section. It is a duplicate of the below section. One
deprecation notice is enough.

> -
> +* eventdev: ABI change to support DLB PMD and future extensions
> +  The following structures and will be modified to support to DLB PMD and future
> +  extension in the eventdev library.
> +  - ``rte_event_dev_info``
> +  - ``rte_event_dev_config``
> +  - ``rte_event_port_conf``
> +  Patches containing justification, documentation, and proposed modifications
> +  can be found at
> +  - https://patches.dpdk.org/patch/71457/
> +  - https://patches.dpdk.org/patch/71456/
> --
> 1.7.10
>
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index ecb1bc4..4809643 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -149,30 +149,13 @@  Deprecation Notices
   In 20.08, explicit deprecation warnings will be displayed when running
   scripts with Python 2.
 
-* eventdev: Three public data structures will be updated in 20.11;
-  ``rte_event_dev_info``, ``rte_event_dev_config``, and
-  ``rte_event_port_conf``.
-  Two new members will be added to the ``rte_event_dev_info`` struct.
-  The first, max_event_port_links, will be a uint8_t, and represents the
-  maximum number of queues that can be linked to a single event port by
-  this device. The second, max_single_link_event_port_queue_pairs, will be a
-  uint8_t, and represents the maximum number of event ports and queues that
-  are optimized for (and only capable of) single-link configurations
-  supported by this device. These ports and queues are not accounted for in
-  max_event_ports or max_event_queues.
-  One new member will be added to the ``rte_event_dev_config`` struct. The
-  nb_single_link_event_port_queues member will be a uint8_t, and will
-  represent the number of event ports and queues that will be singly-linked
-  to each other. These are a subset of the overall event ports and queues.
-  This value cannot exceed nb_event_ports or nb_event_queues. If the
-  device has ports and queues that are optimized for single-link usage, this
-  field is a hint for how many to allocate; otherwise, regular event ports and
-  queues can be used.
-  Finally, the ``rte_event_port_conf`` struct will be
-  modified as follows. The uint8_t implicit_release_disabled field
-  will be replaced by a uint32_t event_port_cfg field. The new field will
-  initially have two bits assigned. RTE_EVENT_PORT_CFG_DISABLE_IMPL_REL
-  will have the same meaning as implicit_release_disabled. The second bit,
-  RTE_EVENT_PORT_CFG_SINGLE_LINK will be set if the event port links only
-  to a single event queue.
-
+* eventdev: ABI change to support DLB PMD and future extensions
+  The following structures and will be modified to support to DLB PMD and future
+  extension in the eventdev library.
+  - ``rte_event_dev_info``
+  - ``rte_event_dev_config``
+  - ``rte_event_port_conf``
+  Patches containing justification, documentation, and proposed modifications
+  can be found at
+  - https://patches.dpdk.org/patch/71457/
+  - https://patches.dpdk.org/patch/71456/