doc: announce API change for sched library
authorJasvinder Singh <jasvinder.singh@intel.com>
Wed, 14 Nov 2018 15:36:42 +0000 (15:36 +0000)
committerThomas Monjalon <thomas@monjalon.net>
Sat, 24 Nov 2018 18:14:22 +0000 (19:14 +0100)
There will be change in API functions because of mbuf sched field
updates, outlined in deprecation note of mbuf->hash.sched.

Signed-off-by: Jasvinder Singh <jasvinder.singh@intel.com>
Acked-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
Acked-by: Reshma Pattan <reshma.pattan@intel.com>
Acked-by: Mohammad Abdul Awal <mohammad.abdul.awal@intel.com>
doc/guides/rel_notes/deprecation.rst

index 6bc5189..55a4c40 100644 (file)
@@ -48,6 +48,11 @@ Deprecation Notices
   is defined in librte_sched in a non-generic way. The new generic format
   will contain: queue ID, traffic class, color. Field size will not change.
 
+* sched: Some API functions will change prototype due to the above
+  deprecation note for mbuf->hash.sched, e.g. ``rte_sched_port_pkt_write()``
+  and ``rte_sched_port_pkt_read()`` will likely have an additional parameter
+  of type ``struct rte_sched_port``.
+
 * mbuf: the macro ``RTE_MBUF_INDIRECT()`` will be removed in v18.08 or later and
   replaced with ``RTE_MBUF_CLONED()`` which is already added in v18.05. As
   ``EXT_ATTACHED_MBUF`` is newly introduced in v18.05, ``RTE_MBUF_INDIRECT()``