From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 688A57F2C for ; Mon, 10 Nov 2014 18:02:06 +0100 (CET) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga101.fm.intel.com with ESMTP; 10 Nov 2014 09:11:48 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.07,353,1413270000"; d="scan'208";a="620053667" Received: from ppfinner-mobl3.ger.corp.intel.com ([10.252.17.162]) by fmsmga001.fm.intel.com with SMTP; 10 Nov 2014 09:11:00 -0800 Received: by (sSMTP sendmail emulation); Mon, 10 Nov 2014 17:10:59 +0025 Date: Mon, 10 Nov 2014 17:10:59 +0000 From: Bruce Richardson To: Olivier Matz Message-ID: <20141110171059.GD10776@bricha3-MOBL3> References: <1415635166-1364-1-git-send-email-olivier.matz@6wind.com> <1415635166-1364-5-git-send-email-olivier.matz@6wind.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1415635166-1364-5-git-send-email-olivier.matz@6wind.com> Organization: Intel Shannon Ltd. User-Agent: Mutt/1.5.23 (2014-03-12) Cc: jigsaw@gmail.com, dev@dpdk.org Subject: Re: [dpdk-dev] [PATCH 04/12] mbuf: add help about TX checksum flags X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Nov 2014 17:02:07 -0000 On Mon, Nov 10, 2014 at 04:59:18PM +0100, Olivier Matz wrote: > Describe how to use hardware checksum API. > > Signed-off-by: Olivier Matz Acked-by: Bruce Richardson > --- > lib/librte_mbuf/rte_mbuf.h | 25 +++++++++++++++++-------- > 1 file changed, 17 insertions(+), 8 deletions(-) > > diff --git a/lib/librte_mbuf/rte_mbuf.h b/lib/librte_mbuf/rte_mbuf.h > index be15168..96e322b 100644 > --- a/lib/librte_mbuf/rte_mbuf.h > +++ b/lib/librte_mbuf/rte_mbuf.h > @@ -95,19 +95,28 @@ extern "C" { > #define PKT_RX_TUNNEL_IPV6_HDR (1ULL << 12) /**< RX tunnel packet with IPv6 header. */ > > #define PKT_TX_VLAN_PKT (1ULL << 55) /**< TX packet is a 802.1q VLAN packet. */ > -#define PKT_TX_IP_CKSUM (1ULL << 54) /**< IP cksum of TX pkt. computed by NIC. */ > + > +/** > + * Enable hardware computation of IP cksum. To use it: > + * - fill l2_len and l3_len in mbuf > + * - set the flags PKT_TX_IP_CKSUM > + * - set the ip checksum to 0 in IP header > + */ > +#define PKT_TX_IP_CKSUM (1ULL << 54) > #define PKT_TX_IPV4_CSUM PKT_TX_IP_CKSUM /**< Alias of PKT_TX_IP_CKSUM. */ > #define PKT_TX_IPV4 PKT_RX_IPV4_HDR /**< IPv4 with no IP checksum offload. */ > #define PKT_TX_IPV6 PKT_RX_IPV6_HDR /**< IPv6 packet */ > > -/* > - * Bits 52+53 used for L4 packet type with checksum enabled. > - * 00: Reserved > - * 01: TCP checksum > - * 10: SCTP checksum > - * 11: UDP checksum > +/** > + * Bits 52+53 used for L4 packet type with checksum enabled: 00: Reserved, > + * 01: TCP checksum, 10: SCTP checksum, 11: UDP checksum. To use hardware > + * L4 checksum offload, the user needs to: > + * - fill l2_len and l3_len in mbuf > + * - set the flags PKT_TX_TCP_CKSUM, PKT_TX_SCTP_CKSUM or PKT_TX_UDP_CKSUM > + * - calculate the pseudo header checksum and set it in the L4 header (only > + * for TCP or UDP). For SCTP, set the crc field to 0. > */ > -#define PKT_TX_L4_NO_CKSUM (0ULL << 52) /**< Disable L4 cksum of TX pkt. */ > +#define PKT_TX_L4_NO_CKSUM (0ULL << 52) /* Disable L4 cksum of TX pkt. */ > #define PKT_TX_TCP_CKSUM (1ULL << 52) /**< TCP cksum of TX pkt. computed by NIC. */ > #define PKT_TX_SCTP_CKSUM (2ULL << 52) /**< SCTP cksum of TX pkt. computed by NIC. */ > #define PKT_TX_UDP_CKSUM (3ULL << 52) /**< UDP cksum of TX pkt. computed by NIC. */ > -- > 2.1.0 >