> -----Original Message-----
> From: Trahe, Fiona
> Sent: Thursday, July 27, 2017 10:03 AM
> To: De Lara Guarch, Pablo <[email protected]>; Doherty,
> Declan <[email protected]>
> Cc: [email protected]; De Lara Guarch, Pablo
> <[email protected]>; [email protected]; Trahe, Fiona
> <[email protected]>
> Subject: RE: [dpdk-dev] [PATCH] cryptodev: fix crypto op bulk alloc Doxygen
> 
> Hi Pablo,
> 
> > -----Original Message-----
> > From: dev [mailto:[email protected]] On Behalf Of Pablo de Lara
> > Sent: Wednesday, July 26, 2017 5:27 AM
> > To: Doherty, Declan <[email protected]>
> > Cc: [email protected]; De Lara Guarch, Pablo
> > <[email protected]>; [email protected]
> > Subject: [dpdk-dev] [PATCH] cryptodev: fix crypto op bulk alloc
> > Doxygen
> >
> > When calling rte_crypto_op_bulk_alloc, the function may return either
> > a 0, if not enough objects are available in the mempool or the number
> > of operations requested, it there are enough available. However, the
> > Doxygen comments were not matching these two cases.
> >
> > Fixes: c0f87eb5252b ("cryptodev: change burst API to be crypto op
> > oriented")
> > Cc: [email protected]
> >
> > Signed-off-by: Pablo de Lara <[email protected]>
> > ---
> >  lib/librte_cryptodev/rte_crypto.h | 4 ++--
> >  1 file changed, 2 insertions(+), 2 deletions(-)
> >
> > diff --git a/lib/librte_cryptodev/rte_crypto.h
> > b/lib/librte_cryptodev/rte_crypto.h
> > index 0908368..9f10818 100644
> > --- a/lib/librte_cryptodev/rte_crypto.h
> > +++ b/lib/librte_cryptodev/rte_crypto.h
> > @@ -266,8 +266,8 @@ rte_crypto_op_alloc(struct rte_mempool
> *mempool,
> > enum rte_crypto_op_type type)
> >   * @param  nb_ops  Number of crypto operations to allocate
> >   *
> >   * @returns
> > - * - On success returns a valid rte_crypto_op structure
> > - * - On failure returns NULL
> > + * - 0 if no operations could be allocated
> > + * - nb_ops if the number of operations requested were allocated
> >   */
> >
> My first thought was what's returned if some ops could be allocated, but
> not the requested number?
> Maybe instead:
> - nb_ops if the number of operations requested were allocated.
> - 0 if the requested number of ops are not available. None are allocated in
> this case.

Good clarification. Will send a v2 shortly.

Thanks,
Pablo

> 
> >  static inline unsigned
> > --
> > 2.9.4

Reply via email to