From patchwork Tue Aug 8 15:00:06 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Github ODP bot X-Patchwork-Id: 109665 Delivered-To: patch@linaro.org Received: by 10.140.95.78 with SMTP id h72csp3061611qge; Tue, 8 Aug 2017 08:01:04 -0700 (PDT) X-Received: by 10.55.22.100 with SMTP id g97mr6035937qkh.228.1502204464881; Tue, 08 Aug 2017 08:01:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1502204464; cv=none; d=google.com; s=arc-20160816; b=uQB6MjLMdye74+NClxNM6+v1v2dZ8ZlkH1OT19TG7/zf7nv6RCk41r0TE4NBX56WZt Stiwl4fPq5GUshlZ+0wbutbqqD3u55IOBBQ6ealLyHkjHYfe3Z/gblBS33MKHwozPUWI ZRJGkXCJ0nfLkstaX/P3rJgDqBk7mwEEFMPJQ3wjHvb+3tbb0H24veBunaelLUVKfGo2 8sUtUKh0oTip3CSyskEPYu+RPc8xMUW5GM6aF1tvEKbx8DCYyuDFhqpGkrbMtcbNwvC1 s0/iRjeq7c9d8LjXwGnpOXK67vGDPvYC3V9TZthaSCbe2wkc3D7Yv2/7MrLNxsA1ZjNx IOSA== 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=fgXCezIQtHlrYDHbl5SvqyrqGq+quD4D1u+SBNffq/4=; b=Qqer7JFejC14Yfjop4kSjO7zSvaXAReKje19IN4LwLv+ckhiRaONxOx/jLm+XMBvBN GbQOdm5xj5Cf3mwpb8bbMFimUqUzyo6yZ3L12ZAx+nV7P5Q/7pxybhEH0LX8RCMr3Xgr nsrcjEQnathO6/aZa32cf9tMY/YKqXLOKhd3vu/s8KJnBRZZf/gvFAwzexa2Omkbws4A yhA/tnk09MUj3hfXja0EnhiSt975VHq5r/Bs8WxNhvemJqgnjZzNRzgBO4IirlFEI23l WGwXvFKqJvq3KzSzz/jSx6Trmxv+VubXH7wPXryie5Ooufu3sp8WBkRLF+5Hrvwh+FK4 iwLw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.225.227.206 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 (lists.linaro.org. [54.225.227.206]) by mx.google.com with ESMTP id d202si1229410qkb.278.2017.08.08.08.01.04; Tue, 08 Aug 2017 08:01:04 -0700 (PDT) Received-SPF: pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.225.227.206 as permitted sender) client-ip=54.225.227.206; Authentication-Results: mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.225.227.206 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 2C9E560C1E; Tue, 8 Aug 2017 15:01:04 +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,URIBL_BLOCKED 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 A5C7160BF4; Tue, 8 Aug 2017 15:00:31 +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 B4AE560A0E; Tue, 8 Aug 2017 15:00:28 +0000 (UTC) Received: from forward19o.cmail.yandex.net (forward19o.cmail.yandex.net [37.9.109.217]) by lists.linaro.org (Postfix) with ESMTPS id 91E9560A0E for ; Tue, 8 Aug 2017 15:00:26 +0000 (UTC) Received: from mxback7o.mail.yandex.net (mxback7o.mail.yandex.net [IPv6:2a02:6b8:0:1a2d::21]) by forward19o.cmail.yandex.net (Yandex) with ESMTP id B735A26181 for ; Tue, 8 Aug 2017 18:00:24 +0300 (MSK) Received: from smtp1o.mail.yandex.net (smtp1o.mail.yandex.net [2a02:6b8:0:1a2d::25]) by mxback7o.mail.yandex.net (nwsmtp/Yandex) with ESMTP id T66XOxBzMV-0ORmSWnf; Tue, 08 Aug 2017 18:00:24 +0300 Received: by smtp1o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id 8BkjjFGb1I-0MnqO4QL; Tue, 08 Aug 2017 18:00:23 +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, 8 Aug 2017 18:00:06 +0300 Message-Id: <1502204406-3634-2-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1502204406-3634-1-git-send-email-odpbot@yandex.ru> References: <1502204406-3634-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 109 Subject: [lng-odp] [PATCH API-NEXT v2 1/1] API:IPSEC: IPSEC events may be reported synchronously. 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: Nikhil Agarwal IPSEC events may be delivered synchronous or ansynchrous depending on implementation. Application will know based on return value of odp_ipsec_sa_disable API. Signed-off-by: Nikhil Agarwal --- /** Email created from pull request 109 (NikhilA-Linaro:disable_event) ** https://github.com/Linaro/odp/pull/109 ** Patch: https://github.com/Linaro/odp/pull/109.patch ** Base sha: e420668cd3886f003c8bd6022e210bf08a0ee3b5 ** Merge commit sha: 60340859600e926a2666640fbdd6840640c2b8a6 **/ include/odp/api/spec/ipsec.h | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/include/odp/api/spec/ipsec.h b/include/odp/api/spec/ipsec.h index 7085bc0d..0a799ff4 100644 --- a/include/odp/api/spec/ipsec.h +++ b/include/odp/api/spec/ipsec.h @@ -831,16 +831,17 @@ odp_ipsec_sa_t odp_ipsec_sa_create(const odp_ipsec_sa_param_t *param); * before calling disable. Packets in progress during the call may still match * the SA and be processed successfully. * - * When in synchronous operation mode, the call will return when it's possible - * to destroy the SA. In asynchronous mode, the same is indicated by an - * ODP_EVENT_IPSEC_STATUS event sent to the queue specified for the SA. The - * status event is guaranteed to be the last event for the SA, i.e. all - * in-progress operations have completed and resulting events (including status - * events) have been enqueued before it. + * When SA is disabled synchronously, the call will return when it's possible + * to destroy the SA indicated by return value 0. If the return value is 1,same + * is indicated by an ODP_EVENT_IPSEC_STATUS event sent to the queue specified + * for the SA. The status event is guaranteed to be the last event for the SA, + * i.e. all in-progress operations have completed and resulting events + * (including status events) have been enqueued before it. * * @param sa IPSEC SA to be disabled * - * @retval 0 On success + * @retval 0 When SA is disabled successfully. + * @retval 1 Disable event will be posted on SA queue. * @retval <0 On failure * * @see odp_ipsec_sa_destroy()