From patchwork Wed Aug 9 11:00:27 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: 109711 Delivered-To: patch@linaro.org Received: by 10.140.95.78 with SMTP id h72csp703478qge; Wed, 9 Aug 2017 04:01:53 -0700 (PDT) X-Received: by 10.237.49.132 with SMTP id 4mr10341149qth.105.1502276513789; Wed, 09 Aug 2017 04:01:53 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1502276513; cv=none; d=google.com; s=arc-20160816; b=ERsu3S7r3vtHu6t0gXe8M50KfBezebMM8Eo7lYBC/U7IqNbfZjIE+L9JWeJRdLZfDV Bzsa/rjFaggoWDgWzeX0S2bMcAy/Gg4l7ILNxe57s2w4OrLIoyb9f7jNpLFuLj5592Td J5RjJQ+Si0ZcsNl563H2AgE1JnFb8S8BGhddVSfSWmV6RnFi1AoWkgwIHrelqkFEGMAJ r8H4tzXnC3ZlnrvVWL3Pn2eGb2juix59i+UPrrFucmnc4pNV+g46MdIw1Oijz077sSPO f9QW0iVvJ2dZgo/X79ZbOsHui7wK5GjMorSFnI7fshJRBQC8I5kuciUbkT3uLk/rWCJK cwrw== 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=MlmYmJ7vCepFtm1zAHdOMzTW6tfvYkyuDaTVLzhQa+E=; b=pnEV+agIDmQfQhpXnsGiHGXJ+zOdz9JFKp54IbvIGDyQGXLDTnZ9vJbWzM9Yrpiibz w7MeB6VGaGOYQtqQabhscfX1ArQgVQN8/In8ebyzrMrdlL9ZdkLytuPHsWpLmxj38YJG Ghg5GpGHdSE0okH0/UDCpiTwpZNHYcxVzPq+UjK5C5pWiUVGkuQr+MhdX6SyS/rYW0EY nKEzHTRvhfvzC+0Ac5Bqq9+TrBKzszRjx2JSTOPjKrhTLVpc+86AqtnP4ydJZBmZYDYK PY+rDndKKR9CSeeeSqwDFktkXgwMAWcgGZAT5mcrvE3q4bR0QFQalRRzZNbxKKlueX0K ysMw== 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 o39si1055632qtk.292.2017.08.09.04.01.53; Wed, 09 Aug 2017 04:01:53 -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 6D4F1609AA; Wed, 9 Aug 2017 11:01:53 +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=-1.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,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 A38DA60CC6; Wed, 9 Aug 2017 11:00:53 +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 6518260CDC; Wed, 9 Aug 2017 11:00:42 +0000 (UTC) Received: from forward101p.mail.yandex.net (forward101p.mail.yandex.net [77.88.28.101]) by lists.linaro.org (Postfix) with ESMTPS id 0C12B60C9F for ; Wed, 9 Aug 2017 11:00:36 +0000 (UTC) Received: from mxback12g.mail.yandex.net (mxback12g.mail.yandex.net [IPv6:2a02:6b8:0:1472:2741:0:8b7:91]) by forward101p.mail.yandex.net (Yandex) with ESMTP id 918EA6A82236 for ; Wed, 9 Aug 2017 14:00:34 +0300 (MSK) Received: from smtp1p.mail.yandex.net (smtp1p.mail.yandex.net [2a02:6b8:0:1472:2741:0:8b6:6]) by mxback12g.mail.yandex.net (nwsmtp/Yandex) with ESMTP id ebtuJmqz7a-0Yl4bKtq; Wed, 09 Aug 2017 14:00:34 +0300 Received: by smtp1p.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id nhEJJezH42-0X4e61O8; Wed, 09 Aug 2017 14:00:34 +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: Wed, 9 Aug 2017 14:00:27 +0300 Message-Id: <1502276427-4161-2-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1502276427-4161-1-git-send-email-odpbot@yandex.ru> References: <1502276427-4161-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 109 Subject: [lng-odp] [PATCH API-NEXT v3 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: 81c5d76191a1ba789535442c2f88161bdca6424f **/ include/odp/api/spec/ipsec.h | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/include/odp/api/spec/ipsec.h b/include/odp/api/spec/ipsec.h index 7085bc0d..5a504ae1 100644 --- a/include/odp/api/spec/ipsec.h +++ b/include/odp/api/spec/ipsec.h @@ -831,16 +831,18 @@ 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. + * A return value 0 indicates that the disable request has completed + * synchronously and the SA is now disabled. A return value 1 indicates that the + * disable request has been accepted and completion will be indicated by an + * ODP_EVENT_IPSEC_STATUS sent to the queue specified for the SA. This 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()