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

[Hemant Agrawal]

> > -----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?
[Hemant] I was just trying to minimize the changes. But it can be done. 

> 
> Regards,
> Fan