[dpdk-dev] [PATCH] doc: announce change in crypto raw data vector

[Zhang, Roy Fan]

Hi Hemant,

> -----Original Message-----
> From: Hemant Agrawal <hemant.agrawal at nxp.com>
> Sent: Thursday, August 5, 2021 9:06 AM
> To: dev at dpdk.org; gakhil at marvell.com
> Cc: anoobj at marvell.com; Nicolau, Radu <radu.nicolau at intel.com>; Doherty,
> Declan <declan.doherty at intel.com>; matan at nvidia.com; Ananyev,
> Konstantin <konstantin.ananyev at intel.com>; thomas at monjalon.net; Zhang,
> Roy Fan <roy.fan.zhang at intel.com>; asomalap at amd.com;
> ruifeng.wang at arm.com; ajit.khaparde at broadcom.com; De Lara Guarch,
> Pablo <pablo.de.lara.guarch at intel.com>; Trahe, Fiona
> <fiona.trahe at intel.com>; adwivedi at marvell.com;
> jianjay.zhou at huawei.com; Gagandeep Singh <G.Singh at nxp.com>
> Subject: [PATCH] doc: announce change in crypto raw data vector
> 
> The current crypto raw data vectors need to be extended to support
> out of place processing. It is proposed to add additional desl_sgl
> to provide details for destination sgl.
> The same is also extended to support rte_security usecases, where
> we need total data length to know how much additional memory space
> is available in buffer other than data length so that driver/HW
> can write expanded size data after encryption.
> 
> Signed-off-by: Gagandeep Singh <G.Singh at nxp.com>
> Signed-off-by: Hemant Agrawal <hemant.agrawal at nxp.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst
> b/doc/guides/rel_notes/deprecation.rst
> index f4a4d00db2..c19a306c93 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -193,3 +193,15 @@ Deprecation Notices
>    reserved bytes to 2 (from 3), and use 1 byte to indicate warnings and other
>    information from the crypto/security operation. This field will be used to
>    communicate events such as soft expiry with IPsec in lookaside mode.
> +
> +* cryptodev: The structure ``rte_crypto_sym_vec`` would be updated to
> add
> +  ``dest_sgl`` to support out of place processing. This field will be null for
> +  inplace processing. This change is targeted for DPDK 21.11
> +
> +* cryptodev: The structure ``rte_crypto_vec`` would be updated to add
> +  ``tot_len`` to support total buffer length. This is required for security
> +  cases like IPsec and PDCP encryption offload to know how much additional
> +  memory space is available in buffer other than data length so that
> driver/HW
> +  can write expanded size data after encryption. This change is targeted for
> +  DPDK 21.11
> +
> --
> 2.17.1

To add ``dest_sgl`` to ``rte_crypto_sym_vec`` I suppose it is better to rename ``sgl`` to ``src_sgl`` in this deprecating notice too?

Regards,
Fan