From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by dpdk.org (Postfix) with ESMTP id 2DF261B455; Fri, 4 Jan 2019 08:16:48 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga105.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 03 Jan 2019 23:16:46 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,437,1539673200"; d="scan'208";a="123191338" Received: from dpdk15.sh.intel.com ([10.67.111.146]) by orsmga002.jf.intel.com with ESMTP; 03 Jan 2019 23:16:45 -0800 From: Jiayu Hu To: dev@dpdk.org Cc: thomas@monjalon.net, Jiayu Hu , stable@dpdk.org Date: Fri, 4 Jan 2019 15:16:40 +0800 Message-Id: <1546586200-38148-1-git-send-email-jiayu.hu@intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1545797073-24844-1-git-send-email-jiayu.hu@intel.com> References: <1545797073-24844-1-git-send-email-jiayu.hu@intel.com> Subject: [dpdk-stable] [PATCH v3] doc: add GRO API limitations in prog_guide X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 04 Jan 2019 07:16:48 -0000 This patch adds GRO API limitations in the programmer guide. Fixes: 2c900d09055e ("doc: add GRO guide") Fixes: 9e0b9d2ec0f4 ("gro: support VxLAN GRO") Cc: stable@dpdk.org Signed-off-by: Jiayu Hu --- changes in v3: - add fix versions - add more limitations - add MBUF limitation doc/guides/prog_guide/generic_receive_offload_lib.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/guides/prog_guide/generic_receive_offload_lib.rst b/doc/guides/prog_guide/generic_receive_offload_lib.rst index 9c6a4d0..c8f9882 100644 --- a/doc/guides/prog_guide/generic_receive_offload_lib.rst +++ b/doc/guides/prog_guide/generic_receive_offload_lib.rst @@ -191,3 +191,18 @@ Header fields deciding if packets are neighbors include: ignore IPv4 ID fields for the packets whose DF bit is 1. Additionally, packets which have different value of DF bit can't be merged. + +GRO Library Limitations +----------------------- + +- GRO library directly uses the values of MBUF->l2_len/l3_len/l4_len/ + outer_l2_len/outer_l3_len to parse packet headers. In addition, + it relies on MBUF->pkt_len/data_len to process packets. Therefore, + to get correct reassembly results, applications must set correct + values to those MBUF metadata fields. + +- GRO library doesn't support to process packets with IPv4 option fields. + +- Currently, GRO library just supports to process the packet organized + in a single MBUF. If the input packet consists of multiple MBUFs, + GRO reassembly behaviors are unknown. -- 2.7.4