From patchwork Tue Jan 16 18:00:25 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Github ODP bot X-Patchwork-Id: 124756 Delivered-To: patch@linaro.org Received: by 10.46.64.148 with SMTP id r20csp1098800lje; Tue, 16 Jan 2018 10:03:11 -0800 (PST) X-Google-Smtp-Source: ACJfBouxO+54X75uR2SVfhRu21vdkWiCL8GlLUrBaLsCTaSE17fB6HTodLSi+h05ViTTWOX3g2Lu X-Received: by 10.55.125.195 with SMTP id y186mr53282055qkc.149.1516125791065; Tue, 16 Jan 2018 10:03:11 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1516125791; cv=none; d=google.com; s=arc-20160816; b=Wthm50unjyPcHGiWq1awC45nI+vhxf61yqM4RhBhBN/3vF5d+K+vkW9F2VHELFej5g hSlx6dsOzdXLjj0i92y0Jl3geg4aLWebbYjt2Pl4GAiCbN/7o+v7I21kAnlcGQqMCfYu CVBHlGDB387OEASgjsn8+MzYyzi9kCo8ovL5NfSRJz1HAM/0mzfgSy2xyXTE3blri/u0 nGCEISI3NQHHudTy8iCdM4gA+UAJ4rHWYj6F2AEmUGu3kFQhmevp/13nk3pkI45N5FtC WkbxWhQircmNtZu1E0TP62EQRvcXMKC9rpwFGxb1Lgm9Gpi5xXUtMNiCEqznyJY03WTD BDqw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:github-pr-num :references:in-reply-to:message-id:date:to:from:delivered-to :arc-authentication-results; bh=d4bgP53wPJQO651fMC8mAS69N+T6FG6YGDakKKgmgCM=; b=ttRi4GrZMi/uSInIRvAz8vlpBhugU5oWlRjuZ6GG+Ej+T8tJz/yeHiDtF1TPEZmhQf R6H6hlt/pYNOpx8iBvyHD+imnY8l8h1l+tQqHlYnUIlBa/37S3XgRfp812cmATMPKArl Og81+0jJQ6+1pQur1GxR6d020Vt0sGYDTvqaPVXtK5GYTMOSLtYjyaRkT6g9Yi+3UL4/ jwEI7RBEYGv+TACbPIcxDm36RnXb1w4mAIHEOuQk4Vuhcd9VsRK2B9NKbtEc6rG3hUpQ pJi6PcAGqr09Ju2Q1e5U933siVfSHvDiMHPJym7WDa1D1dFTuQP6EORyuI+nVqCNK52/ VCjg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Return-Path: Received: from lists.linaro.org (ec2-54-197-127-237.compute-1.amazonaws.com. [54.197.127.237]) by mx.google.com with ESMTP id m1si2638406qkc.406.2018.01.16.10.03.10; Tue, 16 Jan 2018 10:03:11 -0800 (PST) Received-SPF: pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) client-ip=54.197.127.237; Authentication-Results: mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Received: by lists.linaro.org (Postfix, from userid 109) id A5C88617AC; Tue, 16 Jan 2018 18:03:10 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on ip-10-142-244-252 X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL autolearn=disabled version=3.4.0 Received: from [127.0.0.1] (localhost [127.0.0.1]) by lists.linaro.org (Postfix) with ESMTP id 53CFF6178F; Tue, 16 Jan 2018 18:01:55 +0000 (UTC) X-Original-To: lng-odp@lists.linaro.org Delivered-To: lng-odp@lists.linaro.org Received: by lists.linaro.org (Postfix, from userid 109) id 493A1617C9; Tue, 16 Jan 2018 18:01:49 +0000 (UTC) Received: from forward106j.mail.yandex.net (forward106j.mail.yandex.net [5.45.198.249]) by lists.linaro.org (Postfix) with ESMTPS id 93EDB6177E for ; Tue, 16 Jan 2018 18:00:30 +0000 (UTC) Received: from mxback9j.mail.yandex.net (mxback9j.mail.yandex.net [IPv6:2a02:6b8:0:1619::112]) by forward106j.mail.yandex.net (Yandex) with ESMTP id 5050B1804144 for ; Tue, 16 Jan 2018 21:00:29 +0300 (MSK) Received: from smtp4o.mail.yandex.net (smtp4o.mail.yandex.net [2a02:6b8:0:1a2d::28]) by mxback9j.mail.yandex.net (nwsmtp/Yandex) with ESMTP id PT3UoPXLsz-0TYmIuMc; Tue, 16 Jan 2018 21:00:29 +0300 Received: by smtp4o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id ZVsbBwJW64-0S6S3SYL; Tue, 16 Jan 2018 21:00:28 +0300 (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (Client certificate not present) From: Github ODP bot To: lng-odp@lists.linaro.org Date: Tue, 16 Jan 2018 21:00:25 +0300 Message-Id: <1516125627-32748-2-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1516125627-32748-1-git-send-email-odpbot@yandex.ru> References: <1516125627-32748-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 329 Subject: [lng-odp] [PATCH API-NEXT v8 1/3] api: ipsec: document TFC padding usage X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: "The OpenDataPlane \(ODP\) List" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" From: Dmitry Eremin-Solenikov It is possible to include TFC padding into ESP packets. Document usage of such padding according to RFC. Signed-off-by: Dmitry Eremin-Solenikov --- /** Email created from pull request 329 (lumag:ipsec-tfc) ** https://github.com/Linaro/odp/pull/329 ** Patch: https://github.com/Linaro/odp/pull/329.patch ** Base sha: 0c7741d067d9b96e14e420b53a256a1b93096e16 ** Merge commit sha: d31d322b1d7ec8d2b9fc3694df5dd0843b52de1c **/ include/odp/api/spec/ipsec.h | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/include/odp/api/spec/ipsec.h b/include/odp/api/spec/ipsec.h index 4c3c498cd..738dd65ae 100644 --- a/include/odp/api/spec/ipsec.h +++ b/include/odp/api/spec/ipsec.h @@ -1206,6 +1206,14 @@ typedef struct odp_ipsec_status_t { * restored. The amount and content of packet data before the IP header is * undefined. * + * Additional TFC padding might be present after packet contents unless IKEv2 + * ESP_TFC_PADDING_NOT_SUPPORTED notification was used. The resulting ODP + * packet will extend beyond the end of the IP packet it contains or the + * resulting IP packet will extend beyond the end of the IP payload protocol + * (for tunnel or transport cases respectively). An ODP application can detect + * and remove such padding by inspecting the length fields of the relevant + * protocol headers in the result packet. + * * Each successfully transformed packet has a valid value for these metadata * regardless of the inner packet parse configuration * (odp_ipsec_inbound_config_t): @@ -1271,6 +1279,12 @@ int odp_ipsec_in(const odp_packet_t pkt_in[], int num_in, * with IPSEC, etc headers constructed according to the standards. The amount * and content of packet data before the IP header is undefined. * + * Additional TFC padding might be present after packet payload (see RFC 4303 + * section 2.7 for the list of requirements) unless + * ESP_TFC_PADDING_NOT_SUPPORTED notification was used. Such padding should be + * filled by application before submitting packet to ODP. Such padding will be + * included into encrypted packet. Receiver side will skip this padding. + * * Each successfully transformed packet has a valid value for these metadata: * - L3 offset: Offset to the first byte of the (outmost) IP header * From patchwork Tue Jan 16 18:00:26 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Github ODP bot X-Patchwork-Id: 124757 Delivered-To: patch@linaro.org Received: by 10.46.64.148 with SMTP id r20csp1098987lje; Tue, 16 Jan 2018 10:03:48 -0800 (PST) X-Google-Smtp-Source: ACJfBov7c9KHIYw5cnUzpv+AH/BZOMjP1IVohvENq3DLsqcGMGdGVOXaB7Pt1Y2DihKpOMwZx6Ph X-Received: by 10.37.206.1 with SMTP id x1mr7301753ybe.281.1516125828643; Tue, 16 Jan 2018 10:03:48 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1516125828; cv=none; d=google.com; s=arc-20160816; b=b9UqH09XOdXVUblp5zymZpWkQkiC7qEnwy7ZiCIEIcSY/Vxk9CfPQ388x55WGLk5w/ CCLtHB/mCIAglbTSAfOjVEWzfNPmT7hLN8ERBdu0WfVgWbuzsBd2Bvc3y3Hm2CA/2wKX 31rmzqe9M8tR38RDqKNuWLpUTiyjZ2zBYzm9KSPJy3TLMl/nX9PN5kZYN1+OV7AHO4gx 8Xpym/F1LFXi/xduC9lzlnTIfqvxOiIZ8MIM0J8j5v/+yM6BxrDL0aO1SLJyw2s1t3IA UE/F2fSpwCBuamZa0JadqBqCcWETdtKIbzdBo4ZSdJJeS8fn0ahrdYP2MjCewXhyzYef mpsg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:github-pr-num :references:in-reply-to:message-id:date:to:from:delivered-to :arc-authentication-results; bh=qOnw9b2Qr51eQtX7pIPotAJAkcuha/WEL3+5bSp6n+0=; b=cm4zASsfqZ+9eEAzMgoM4LgWBklp7lmY7GJ+alTe3EgFZnNDrdTsyEQL8Q9wd4WeLe psmkXswoqPfPaTqgzWmN+1otC3S70pi3GaCez1VMVZgoLAfaVnlOBYAsbBsbnezxiW0u /7Hg+aclWUuX4tTuSUvPVbRnkjOmc/IS0qVU+uJO9PX6vnLh5TRt/CHc8MQjPKVQMK/m EEl6r0OtsJ1Lb79zEOT6yEX1zGg8zAbcCZI+z/khFqkcEBYTtyxhQPbsUvA7znNEhNeA NEgrpfH4wvTHwE4N+zqkL0vadPgC9xNTYNyeZJqlBa0OnFfQXYON97VzYjnRLP8i0Uyh yszQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Return-Path: Received: from lists.linaro.org (ec2-54-197-127-237.compute-1.amazonaws.com. [54.197.127.237]) by mx.google.com with ESMTP id u2si2854364qke.217.2018.01.16.10.03.48; Tue, 16 Jan 2018 10:03:48 -0800 (PST) Received-SPF: pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) client-ip=54.197.127.237; Authentication-Results: mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Received: by lists.linaro.org (Postfix, from userid 109) id 3511861796; Tue, 16 Jan 2018 18:03:48 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on ip-10-142-244-252 X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL autolearn=disabled version=3.4.0 Received: from [127.0.0.1] (localhost [127.0.0.1]) by lists.linaro.org (Postfix) with ESMTP id 93806617C9; Tue, 16 Jan 2018 18:02:02 +0000 (UTC) X-Original-To: lng-odp@lists.linaro.org Delivered-To: lng-odp@lists.linaro.org Received: by lists.linaro.org (Postfix, from userid 109) id 1277761796; Tue, 16 Jan 2018 18:01:51 +0000 (UTC) Received: from forward106p.mail.yandex.net (forward106p.mail.yandex.net [77.88.28.109]) by lists.linaro.org (Postfix) with ESMTPS id 778B061796 for ; Tue, 16 Jan 2018 18:00:31 +0000 (UTC) Received: from mxback15g.mail.yandex.net (mxback15g.mail.yandex.net [IPv6:2a02:6b8:0:1472:2741:0:8b7:94]) by forward106p.mail.yandex.net (Yandex) with ESMTP id D59C02D836CD for ; Tue, 16 Jan 2018 21:00:29 +0300 (MSK) Received: from smtp4o.mail.yandex.net (smtp4o.mail.yandex.net [2a02:6b8:0:1a2d::28]) by mxback15g.mail.yandex.net (nwsmtp/Yandex) with ESMTP id o1pQunovsC-0TSGDeZK; Tue, 16 Jan 2018 21:00:29 +0300 Received: by smtp4o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id ZVsbBwJW64-0T6OVGYF; Tue, 16 Jan 2018 21:00:29 +0300 (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (Client certificate not present) From: Github ODP bot To: lng-odp@lists.linaro.org Date: Tue, 16 Jan 2018 21:00:26 +0300 Message-Id: <1516125627-32748-3-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1516125627-32748-1-git-send-email-odpbot@yandex.ru> References: <1516125627-32748-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 329 Subject: [lng-odp] [PATCH API-NEXT v8 2/3] api: ipsec: add tfc_padding_truncate capability X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: "The OpenDataPlane \(ODP\) List" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" From: Dmitry Eremin-Solenikov Some hardware truncates TFC padding from received packets. Application can use this capability to determine if it should use ESP_TFC_PADDING_NOT_SUPPORTED notification when negotiating SA. Signed-off-by: Dmitry Eremin-Solenikov --- /** Email created from pull request 329 (lumag:ipsec-tfc) ** https://github.com/Linaro/odp/pull/329 ** Patch: https://github.com/Linaro/odp/pull/329.patch ** Base sha: 0c7741d067d9b96e14e420b53a256a1b93096e16 ** Merge commit sha: d31d322b1d7ec8d2b9fc3694df5dd0843b52de1c **/ include/odp/api/spec/ipsec.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/include/odp/api/spec/ipsec.h b/include/odp/api/spec/ipsec.h index 738dd65ae..29129a93d 100644 --- a/include/odp/api/spec/ipsec.h +++ b/include/odp/api/spec/ipsec.h @@ -232,6 +232,12 @@ typedef struct odp_ipsec_capability_t { */ odp_support_t pipeline_cls; + /** Implementation will automatically truncate TFC padding in received + * packets in ESP tunnel mode. Application can use this capability to + * determine necessity for ESP_TFC_PADDING_NOT_SUPPORTED notification. + */ + odp_support_t tfc_padding_truncate; + /** * Support of retaining outer headers (retain_outer) in inbound inline * processed packets From patchwork Tue Jan 16 18:00:27 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Github ODP bot X-Patchwork-Id: 124758 Delivered-To: patch@linaro.org Received: by 10.46.64.148 with SMTP id r20csp1099200lje; Tue, 16 Jan 2018 10:04:31 -0800 (PST) X-Google-Smtp-Source: ACJfBoukErkHtR86EW0wxmAxFYUh9E8ADWKN/8Fm7vn7BhhWR7U+0VYr2mS3va51kpOKhs4NZPdK X-Received: by 10.237.45.7 with SMTP id h7mr20027844qtd.44.1516125871548; Tue, 16 Jan 2018 10:04:31 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1516125871; cv=none; d=google.com; s=arc-20160816; b=rMW2aX+u3+SyJaQxQYhnliNj4ZDYOV/WDPlxHKrq660YqArV8h45w9Jcah5g7MUc63 wXRjNUheikWFVud2eZt20krmWRKupjWbbP4p4+LEsVOfdKkIG9BPJziTRzr9P2OrhIyc HL0HYsV+m3OxF0aBfPdT1t+Jqnw+0p60jGOmO0wqax8IA1zNCi14+E9gdiybwsC3kcqO GIUysz1ZSTA3vBPBTkSRtHcfOPmsKl0r1CpQ+RJQ5+IeVR2DFpv19Fp3dabLUvVmY0So orQSpK6atoTl1LWNyVy1EVEk19D0nbqOWQqkkOSWBSKvigc7QUiZULElj265+sNvscWd bNUw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:github-pr-num :references:in-reply-to:message-id:date:to:from:delivered-to :arc-authentication-results; bh=2f8/4ULe/TW+2lOrNjy9az2dkfpnkOnJeaDtyNQpFrs=; b=wKOu7MmHwVvNmKnL2iRXN8A18aC+ExMcHwhgsx5ma8ZNQVINr/feSuSaPJtZDptYkB kcrRXrkpk5rkuVrPluwTW2kKdqwpkyKYVDR8fsWoHTJr6YOrHdRUmlhJCBQqCxwh+viW tcpfWYgLx2j9ygGfxhUy0Jenvw1FrWInBBzaXQXxnu0cUZ0fqHx9Nt5aFzf3prLbe+s6 d+75K0xq3JZWIVBM1DrvGevUFoJXhTsf6vlsVmhjTvRYbBzkO3eehKX/tIAvkM+cP68Q cQEv++g4Iz+i/JtG/H9Zq4aBmTQqw5criUtAa/+nE8l0ZqcHPcovMT+xCMzaaR6ixAeD ufQA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Return-Path: Received: from lists.linaro.org (ec2-54-197-127-237.compute-1.amazonaws.com. [54.197.127.237]) by mx.google.com with ESMTP id b73si2791787qkj.50.2018.01.16.10.04.31; Tue, 16 Jan 2018 10:04:31 -0800 (PST) Received-SPF: pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) client-ip=54.197.127.237; Authentication-Results: mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Received: by lists.linaro.org (Postfix, from userid 109) id 3ACAA617AC; Tue, 16 Jan 2018 18:04:31 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on ip-10-142-244-252 X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2 autolearn=disabled version=3.4.0 Received: from [127.0.0.1] (localhost [127.0.0.1]) by lists.linaro.org (Postfix) with ESMTP id D746F617E6; Tue, 16 Jan 2018 18:02:06 +0000 (UTC) X-Original-To: lng-odp@lists.linaro.org Delivered-To: lng-odp@lists.linaro.org Received: by lists.linaro.org (Postfix, from userid 109) id F0631617CC; Tue, 16 Jan 2018 18:01:51 +0000 (UTC) Received: from forward100p.mail.yandex.net (forward100p.mail.yandex.net [77.88.28.100]) by lists.linaro.org (Postfix) with ESMTPS id CD909617AB for ; Tue, 16 Jan 2018 18:00:31 +0000 (UTC) Received: from mxback5o.mail.yandex.net (mxback5o.mail.yandex.net [IPv6:2a02:6b8:0:1a2d::1f]) by forward100p.mail.yandex.net (Yandex) with ESMTP id 6CC025101AB3 for ; Tue, 16 Jan 2018 21:00:30 +0300 (MSK) Received: from smtp4o.mail.yandex.net (smtp4o.mail.yandex.net [2a02:6b8:0:1a2d::28]) by mxback5o.mail.yandex.net (nwsmtp/Yandex) with ESMTP id BIWHyUZ7VR-0U3CCjpw; Tue, 16 Jan 2018 21:00:30 +0300 Received: by smtp4o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id ZVsbBwJW64-0T6esQju; Tue, 16 Jan 2018 21:00:29 +0300 (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (Client certificate not present) From: Github ODP bot To: lng-odp@lists.linaro.org Date: Tue, 16 Jan 2018 21:00:27 +0300 Message-Id: <1516125627-32748-4-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1516125627-32748-1-git-send-email-odpbot@yandex.ru> References: <1516125627-32748-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 329 Subject: [lng-odp] [PATCH API-NEXT v8 3/3] api: ipsec: document usage of IPv4/IPv6 flags on inbound packets X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: "The OpenDataPlane \(ODP\) List" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" From: Dmitry Eremin-Solenikov Document usage of IPv4/IPv6 flags on inbound packets. Provide special case for TFC dummy packets, which are marked by both flags being cleared. Signed-off-by: Dmitry Eremin-Solenikov --- /** Email created from pull request 329 (lumag:ipsec-tfc) ** https://github.com/Linaro/odp/pull/329 ** Patch: https://github.com/Linaro/odp/pull/329.patch ** Base sha: 0c7741d067d9b96e14e420b53a256a1b93096e16 ** Merge commit sha: d31d322b1d7ec8d2b9fc3694df5dd0843b52de1c **/ include/odp/api/spec/ipsec.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/include/odp/api/spec/ipsec.h b/include/odp/api/spec/ipsec.h index 29129a93d..f34324b04 100644 --- a/include/odp/api/spec/ipsec.h +++ b/include/odp/api/spec/ipsec.h @@ -1223,9 +1223,12 @@ typedef struct odp_ipsec_status_t { * Each successfully transformed packet has a valid value for these metadata * regardless of the inner packet parse configuration * (odp_ipsec_inbound_config_t): - * - L3 offset: Offset to the first byte of the (outmost) IP header - * - pktio: For inline IPSEC processed packets, original packet input - * interface + * - L3 offset: Offset to the first byte of the (outmost) IP header + * - IPv4/IPv6 flags: These flags can be used to determine packet contents. + * If neither IPv4 nor IPv6 flag are set, received packet is + * TFC dummy packet and should be dropped by an application + * - pktio: For inline IPSEC processed packets, original packet input + * interface * * Other metadata for parse results and error checks depend on configuration * (selected parse and error check levels).