From mboxrd@z Thu Jan  1 00:00:00 1970
From: Olivier Matz <olivier.matz@6wind.com>
Subject: Re: [PATCH 1/4] rte_mbuf: add rte_pktmbuf_coalesce
Date: Fri, 16 Dec 2016 11:06:04 +0100
Message-ID: <20161216110604.7097488e@platinum>
References: <1480698466-17620-1-git-send-email-tomaszx.kulasek@intel.com>
 <1480698466-17620-2-git-send-email-tomaszx.kulasek@intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Cc: dev@dpdk.org
To: Tomasz Kulasek <tomaszx.kulasek@intel.com>
Return-path: <dev-bounces@dpdk.org>
Received: from mail-wm0-f50.google.com (mail-wm0-f50.google.com [74.125.82.50])
 by dpdk.org (Postfix) with ESMTP id 7C9F7282
 for <dev@dpdk.org>; Fri, 16 Dec 2016 11:06:06 +0100 (CET)
Received: by mail-wm0-f50.google.com with SMTP id a197so25579240wmd.0
 for <dev@dpdk.org>; Fri, 16 Dec 2016 02:06:06 -0800 (PST)
In-Reply-To: <1480698466-17620-2-git-send-email-tomaszx.kulasek@intel.com>
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

Hi Tomasz,

On Fri,  2 Dec 2016 18:07:43 +0100, Tomasz Kulasek
<tomaszx.kulasek@intel.com> wrote:
> This patch adds function rte_pktmbuf_coalesce to let crypto PMD
> coalesce chained mbuf before crypto operation and extend their
> capabilities to support segmented mbufs when device cannot handle
> them natively.
> 
> 
> Signed-off-by: Tomasz Kulasek <tomaszx.kulasek@intel.com>
> ---
>  lib/librte_mbuf/rte_mbuf.h |   34 ++++++++++++++++++++++++++++++++++
>  1 file changed, 34 insertions(+)
> 
> diff --git a/lib/librte_mbuf/rte_mbuf.h b/lib/librte_mbuf/rte_mbuf.h
> index ead7c6e..f048681 100644
> --- a/lib/librte_mbuf/rte_mbuf.h
> +++ b/lib/librte_mbuf/rte_mbuf.h
> @@ -1647,6 +1647,40 @@ static inline int rte_pktmbuf_chain(struct
> rte_mbuf *head, struct rte_mbuf *tail }
>  
>  /**
> + * Coalesce data from mbuf to the continuous buffer.
> + *
> + * @param mbuf_dst
> + *   Contiguous destination mbuf
> + * @param mbuf_src
> + *   Uncontiguous source mbuf
> + *
> + * @return
> + *   - 0, on success
> + *   - -EINVAL, on error
> + */

I think the API should be clarified. In your case, it is expected that the
destination mbuf is already filled with uninitialized data (i.e. that
rte_pktmbuf_append() has been called).

We could wonder if a better API wouldn't be to allocate the dst mbuf in
the function, call append()/prepend(), and do the copy.

Even better, we could have:

  int rte_pktmbuf_linearize(struct rte_mbuf *m)

It will reuse the same mbuf (maybe moving the data).


> +
> +#include <rte_hexdump.h>

This should be removed.

> +
> +static inline int
> +rte_pktmbuf_coalesce(struct rte_mbuf *mbuf_dst, struct rte_mbuf *mbuf_src) {

Source mbuf should be const.

> +	char *dst;
> +
> +	if (!rte_pktmbuf_is_contiguous(mbuf_dst) ||
> +			rte_pktmbuf_data_len(mbuf_dst) >=
> +			rte_pktmbuf_pkt_len(mbuf_src))
> +		return -EINVAL;

Why >= ?

> +
> +	dst = rte_pktmbuf_mtod(mbuf_dst, char *);
> +
> +	if (!__rte_pktmbuf_read(mbuf_src, 0, rte_pktmbuf_pkt_len(mbuf_src),
> +			dst))

When a function returns a pointer, I think it is clearer to do:
  if (func() == NULL)
than:
  if (!func())


> +		return -EINVAL;
> +
> +	return 0;
> +}
> +
> +/**
>   * Dump an mbuf structure to a file.
>   *
>   * Dump all fields for the given packet mbuf and all its associated


One more question, I don't see where this function is used in your
patchset. What is your use-case?

Regards,
Olivier