doc: announce API change in crypto driver allocation
authorPablo de Lara <pablo.de.lara.guarch@intel.com>
Thu, 3 Aug 2017 01:02:36 +0000 (02:02 +0100)
committerThomas Monjalon <thomas@monjalon.net>
Tue, 8 Aug 2017 10:21:32 +0000 (12:21 +0200)
rte_cryptodev_allocate_driver() function gets one parameter
(rte_driver), as the cryptodev_driver structure is
allocated inside the function with rte_malloc.

This function is called from a constructor function,
when crypto PMDs are registered.
If malloc fails, there is no way to recover from it,
so it is better to allocate this structure
statically, in each PMD.

Therefore, it is required to add an extra parameter in
this function, to also get a pointer to this structure.

Signed-off-by: Pablo de Lara <pablo.de.lara.guarch@intel.com>
Acked-by: John McNamara <john.mcnamara@intel.com>
Acked-by: Akhil Goyal <akhil.goyal@nxp.com>
Acked-by: Deepak Kumar Jain <deepak.k.jain@intel.com>
doc/guides/rel_notes/deprecation.rst

index 2f2f0d2..11a9d09 100644 (file)
@@ -106,6 +106,12 @@ Deprecation Notices
 
   - ``rte_cryptodev_vdev_pmd_init``
 
+* cryptodev: the following function will have an extra parameter, passing a
+  statically allocated crypto driver structure, instead of calling malloc,
+  in 17.11:
+
+  - ``rte_cryptodev_allocate_driver``
+
 * librte_table: The ``key_mask`` parameter will be added to all the hash tables
   that currently do not have it, as well as to the hash compute function prototype.
   The non-"do-sig" versions of the hash tables will be removed