From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <stable-bounces@dpdk.org>
Received: from dpdk.org (dpdk.org [92.243.14.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 73E9DA052B
	for <public@inbox.dpdk.org>; Fri, 10 Jul 2020 15:16:09 +0200 (CEST)
Received: from [92.243.14.124] (localhost [127.0.0.1])
	by dpdk.org (Postfix) with ESMTP id 562491DC39;
	Fri, 10 Jul 2020 15:16:09 +0200 (CEST)
Received: from mail-wm1-f68.google.com (mail-wm1-f68.google.com
 [209.85.128.68]) by dpdk.org (Postfix) with ESMTP id AFFA21DB17
 for <stable@dpdk.org>; Fri, 10 Jul 2020 15:16:06 +0200 (CEST)
Received: by mail-wm1-f68.google.com with SMTP id f139so5878581wmf.5
 for <stable@dpdk.org>; Fri, 10 Jul 2020 06:16:06 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind.com; s=google;
 h=date:from:to:cc:subject:message-id:references:mime-version
 :content-disposition:content-transfer-encoding:in-reply-to
 :user-agent; bh=bek4qifzQGRBianoQzBz3CcTYnGJKrSkyLCVhvz2XGM=;
 b=Ez27U+wDxvup+1mSbGFSzsI6Car9B+p5ELwOXm1qMM4HP0FVJiThQeJ7vMNCXQAwj/
 EfQrfwr3hMace50dLlpwPSzQE6ze5dWC5KqTKEYIcla2fSsBJkUH3Gnefyfo5YHGy/+S
 vD89LCg496HIPa0+w52hr1MUe5wLjsAiV8p0Kho3jGouP9edMv3I29NPSkgrluxbw6/l
 5A2lQD8+pPsaYcfVaos+R1uvnpkrzZb9j6tXb75Tbbuh3jTka3sucxiYOjqd/yPGjIWv
 M/+I38FQcfSkx10SGptvECARJ+v9c4qHub2RoD+uqlxLvtzKOGZV3eR4m89XW7+U9N7y
 3pEg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:date:from:to:cc:subject:message-id:references
 :mime-version:content-disposition:content-transfer-encoding
 :in-reply-to:user-agent;
 bh=bek4qifzQGRBianoQzBz3CcTYnGJKrSkyLCVhvz2XGM=;
 b=oTbIQfKujJp7Gq2mT9zMc1GX5lTkI05ArBOCZaf8NvJ8Dpw/gBOHXm9d/6ibnpkEJV
 Kpu4E9LnocEJWr4ZsmhSFtpZBwtFWYueh3jWU9YKP1WRxpyiHf3MTqs9gz04bDGi071e
 b8DYDETpIxnfjimdvfvbuVke936pgxMTmuZmNL2eOoy0EPBkKb/onyETVnggz4yc9BkP
 r+/4a05rTneocrzSRM8SNE5ItsOOY6f3/+/9UJVuz1znpLSUKgeOO7PHcNRxyMUub85P
 CCmOpc+ruyoof9IF0Tl5eg7gGmeEzZPA6wxOvoMzYFqBe8/4/BttFjeNKQ6ceV3+nH4p
 avkw==
X-Gm-Message-State: AOAM5308M2pm9Ol6N+db+iaL2/OVuc7kQyTMlWVHcwbvYGDZXfWBCfZ8
 xBD6QQPUN68qImZ6tjfSpvQ6Pw==
X-Google-Smtp-Source: ABdhPJwKQUz+8QFQUBSVGuVpmF6D3feqSAx39bjLcUOWsvWRU9NjZTJiC0lapwJbORqWI9Ss5TJmIg==
X-Received: by 2002:a1c:e0c4:: with SMTP id x187mr4947278wmg.153.1594386966312; 
 Fri, 10 Jul 2020 06:16:06 -0700 (PDT)
Received: from 6wind.com (2a01cb0c0005a600345636f7e65ed1a0.ipv6.abo.wanadoo.fr.
 [2a01:cb0c:5:a600:3456:36f7:e65e:d1a0])
 by smtp.gmail.com with ESMTPSA id g13sm10207487wro.84.2020.07.10.06.16.05
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Fri, 10 Jul 2020 06:16:05 -0700 (PDT)
Date: Fri, 10 Jul 2020 15:16:04 +0200
From: Olivier Matz <olivier.matz@6wind.com>
To: Morten =?iso-8859-1?Q?Br=F8rup?= <mb@smartsharesystems.com>
Cc: Hongzhi Guo <guohongzhi1@huawei.com>, dev@dpdk.org, stable@dpdk.org,
 stephen@networkplumber.org, thomas@monjalon.net,
 konstantin.ananyev@intel.com, ferruh.yigit@intel.com,
 nicolas.chautru@intel.com, zhoujingbin@huawei.com,
 chenchanghu@huawei.com, jerry.lilijun@huawei.com, haifeng.lin@huawei.com
Message-ID: <20200710131604.GB5869@platinum>
References: <20200710065551.59352-1-guohongzhi1@huawei.com>
 <20200710124109.GY5869@platinum>
 <98CBD80474FA8B44BF855DF32C47DC35C61118@smartserver.smartshare.dk>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <98CBD80474FA8B44BF855DF32C47DC35C61118@smartserver.smartshare.dk>
User-Agent: Mutt/1.10.1 (2018-07-13)
Subject: Re: [dpdk-stable] [PATCH] net: fix unneeded replacement of 0 by
 ffff for TCP checksum
X-BeenThere: stable@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: patches for DPDK stable branches <stable.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/stable>,
 <mailto:stable-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/stable/>
List-Post: <mailto:stable@dpdk.org>
List-Help: <mailto:stable-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/stable>,
 <mailto:stable-request@dpdk.org?subject=subscribe>
Errors-To: stable-bounces@dpdk.org
Sender: "stable" <stable-bounces@dpdk.org>

On Fri, Jul 10, 2020 at 03:10:34PM +0200, Morten Brørup wrote:
> > From: Olivier Matz [mailto:olivier.matz@6wind.com]
> > Sent: Friday, July 10, 2020 2:41 PM
> > 
> > On Fri, Jul 10, 2020 at 02:55:51PM +0800, Hongzhi Guo wrote:
> > > Per RFC768:
> > > If the computed checksum is zero, it is transmitted as all ones.
> > > An all zero transmitted checksum value means that the transmitter
> > > generated no checksum.
> > >
> > > RFC793 for TCP has no such special treatment for the checksum of
> > zero.
> > >
> > > Fixes: 6006818cfb26 ("net: new checksum functions")
> > > Cc: stable@dpdk.org
> > >
> > > Signed-off-by: Hongzhi Guo <guohongzhi1@huawei.com>
> > > ---
> > > v2:
> > > * Fixed commit tile
> > > * Fixed the API comment
> > > ---
> > > ---
> > >  lib/librte_net/rte_ip.h | 18 +++++++++++++++---
> > >  1 file changed, 15 insertions(+), 3 deletions(-)
> > >
> > > diff --git a/lib/librte_net/rte_ip.h b/lib/librte_net/rte_ip.h
> > > index 292f63fd7..d03c77120 100644
> > > --- a/lib/librte_net/rte_ip.h
> > > +++ b/lib/librte_net/rte_ip.h
> > > @@ -325,7 +325,7 @@ rte_ipv4_phdr_cksum(const struct rte_ipv4_hdr
> > *ipv4_hdr, uint64_t ol_flags)
> > >   *   The pointer to the beginning of the L4 header.
> > >   * @return
> > >   *   The complemented checksum to set in the IP packet
> > > - *   or 0 on error
> > > + *   or 0 if the IP length is invalid in the header.
> > >   */
> > >  static inline uint16_t
> > >  rte_ipv4_udptcp_cksum(const struct rte_ipv4_hdr *ipv4_hdr, const
> > void *l4_hdr)
> 
> 0 is a valid return value, so I suggest omitting it from the return value description:
> 
>   * @return
> - *   The complemented checksum to set in the IP packet
> - *   or 0 on error
> + *   The complemented checksum to set in the IP packet.
> 
> The comparison "if (l3_len < sizeof(struct rte_ipv4_hdr))" is only there to protect against invalid input; it prevents l4_len from becoming negative.

I don't get why "0 if the IP length is invalid in the header" should
be removed from the comment: 0 is both a valid return value and
the value returned on invalid packet.

> For the same reason, unlikely() should be added to this comparison.

Maybe yes, but that's another story I think.

> Otherwise,
> 
> Acked-by: Morten Brørup <mb@smartsharesystems.com>
>