From mboxrd@z Thu Jan  1 00:00:00 1970
From: Thomas Monjalon <thomas@monjalon.net>
Subject: Re: [DPDK] lib/librte_ether: add comments RSS flags
Date: Wed, 10 Jan 2018 08:38:56 +0100
Message-ID: <3352601.Q3XN9ClvY9@xps>
References: <20180104181506.153697-1-qiming.yang@intel.com>
 <1569196.tzFYU9QD0F@xps>
 <F5DF4F0E3AFEF648ADC1C3C33AD4DBF16F8232E4@SHSMSX101.ccr.corp.intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7Bit
Cc: Shahaf Shuler <shahafs@mellanox.com>,
 Andrew Rybchenko <arybchenko@solarflare.com>, dev@dpdk.org
To: "Yang, Qiming" <qiming.yang@intel.com>
Return-path: <dev-bounces@dpdk.org>
Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com
 [66.111.4.27]) by dpdk.org (Postfix) with ESMTP id 5C64E1B01F
 for <dev@dpdk.org>; Wed, 10 Jan 2018 08:39:25 +0100 (CET)
In-Reply-To: <F5DF4F0E3AFEF648ADC1C3C33AD4DBF16F8232E4@SHSMSX101.ccr.corp.intel.com>
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://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: <https://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

10/01/2018 03:15, Yang, Qiming:
> From: Thomas Monjalon [mailto:thomas@monjalon.net]
> > 07/01/2018 07:32, Shahaf Shuler:
> > > Saturday, January 6, 2018 12:22 PM, Andrew Rybchenko:
> > >
> > > [..]
> > >
> > > > >   #define ETH_RSS_PORT               (1ULL << RTE_ETH_FLOW_PORT)
> > > > > +/** Enable RSS offload on VXLAN packets */
> > > > >   #define ETH_RSS_VXLAN              (1ULL << RTE_ETH_FLOW_VXLAN)
> > > > > +/** Enable RSS offload on GENEVE packets */
> > > > >   #define ETH_RSS_GENEVE             (1ULL << RTE_ETH_FLOW_GENEVE)
> > > > > +/** Enable RSS offload on NVGRE packets */
> > > > >   #define ETH_RSS_NVGRE              (1ULL << RTE_ETH_FLOW_NVGRE)
> > > > >
> > > > >   #define ETH_RSS_IP ( \
> > > >
> > > > These comments just decode the define name and not that useful. What
> > > > would be really useful here is specification of which fields of the
> > > > packet headers are used to calculate hash especially in the case of tunnels.
> > >
> > > +1.
> > >
> > > Also maybe some more clarifications, for example:
> > > 1. What is the expected behavior when, for example, setting the
> > ETH_RSS_IPV6_EX and regular IPv6 packet arrives? is RSS apply on it?
> > > 2. What is the expected behavior from the PMD when not supporting one of
> > the RSS types?
> > >      For example most of the DPDK examples uses ETH_RSS_IP [1], however
> > very few devices actually supports each and every RSS type.
> > >      Assuming such configuration returns with no error, what should application
> > expect when unsupported packet type arrives.
> > >
> > > #define ETH_RSS_IP ( \
> > >         ETH_RSS_IPV4 | \
> > >         ETH_RSS_FRAG_IPV4 | \
> > >         ETH_RSS_NONFRAG_IPV4_OTHER | \
> > >         ETH_RSS_IPV6 | \
> > >         ETH_RSS_FRAG_IPV6 | \
> > >         ETH_RSS_NONFRAG_IPV6_OTHER | \
> > >         ETH_RSS_IPV6_EX)
> > 
> > +1
> > We really need a detailed documentation of the.
> > 
> 
> I agree with your comments, but the same RSS configuration may have different behavior(RSS offload and input set) in different driver.

This is a bug!
The API must have the same meaning for all drivers.

> Adding driver specific information in rte_ethdev.h  is not suitable.
> So I think the best scheme is to update driver's document to detail the exact behavior and add reference doc here.
> 
> > It must be at least as detailed as lib/librte_mbuf/rte_mbuf_ptype.h.
> > Thanks