doc: announce crypto device type enumeration removal
[dpdk.git] / doc / guides / rel_notes / deprecation.rst
index 02f64ee..978c950 100644 (file)
@@ -28,26 +28,17 @@ Deprecation Notices
   has exposed, like the way we have done with uio-pci-generic. This change
   targets release 17.05.
 
-* vfio: Some functions are planned to be exported outside librte_eal in 17.05.
-  VFIO APIs like ``vfio_setup_device``, ``vfio_get_group_fd`` can be used by
-  subsystem other than EAL/PCI. For that, these need to be exported symbols.
-  Such APIs are planned to be renamed according to ``rte_*`` naming convention
-  and exported from librte_eal.
-
 * The VDEV subsystem will be converted as driver of the new bus model.
-  It will imply some EAL API changes in 17.05.
+  It may imply some EAL API changes in 17.08.
 
-* ``eth_driver`` is planned to be removed in 17.05. 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``. Similarly, ``rte_pci_driver`` is planned to be removed from
-  ``rte_cryptodev_driver`` in 17.05.
+* The struct ``rte_pci_driver`` is planned to be removed from
+  ``rte_cryptodev_driver`` and ``rte_eventdev_driver`` in 17.08.
 
-* ethdev: An API change is planned for 17.05 for the function
-  ``_rte_eth_dev_callback_process``. In 17.05 the function will return an ``int``
+* ethdev: An API change is planned for 17.08 for the function
+  ``_rte_eth_dev_callback_process``. In 17.08 the function will return an ``int``
   instead of ``void`` and a fourth parameter ``void *ret_param`` will be added.
 
-* ethdev: for 17.05 it is planned to deprecate the following nine rte_eth_dev_*
+* ethdev: for 17.08 it is planned to deprecate the following nine rte_eth_dev_*
   functions and move them into the ixgbe PMD:
 
   ``rte_eth_dev_bypass_init``, ``rte_eth_dev_bypass_state_set``,
@@ -73,7 +64,7 @@ Deprecation Notices
 * The mbuf flags PKT_RX_VLAN_PKT and PKT_RX_QINQ_PKT are deprecated and
   are respectively replaced by PKT_RX_VLAN_STRIPPED and
   PKT_RX_QINQ_STRIPPED, that are better described. The old flags and
-  their behavior will be kept until 17.02 and will be removed in 17.05.
+  their behavior will be kept until 17.05 and will be removed in 17.08.
 
 * ethdev: Tx offloads will no longer be enabled by default in 17.08.
   Instead, the ``rte_eth_txmode`` structure will be extended with
@@ -90,6 +81,17 @@ Deprecation Notices
   Target release for removal of the legacy API will be defined once most
   PMDs have switched to rte_flow.
 
+* cryptodev: All PMD names definitions will be moved to the individual PMDs
+  in 17.08.
+
+* cryptodev: The following changes will be done in in 17.08:
+
+  - the device type enumeration ``rte_cryptodev_type`` will be removed
+  - the following structures will be changed: ``rte_cryptodev_session``,
+    ``rte_cryptodev_sym_session``, ``rte_cryptodev_info``, ``rte_cryptodev``
+  - the function ``rte_cryptodev_count_devtype`` will be replaced by
+    ``rte_cryptodev_device_count_by_driver``
+
 * crypto/scheduler: the following two functions are deprecated starting
   from 17.05 and will be removed in 17.08: