From patchwork Mon Feb 5 15:00:07 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: 126902 Delivered-To: patch@linaro.org Received: by 10.46.124.24 with SMTP id x24csp2044826ljc; Mon, 5 Feb 2018 07:02:32 -0800 (PST) X-Google-Smtp-Source: AH8x227V0Q0ffFtgq1n6Y2cwKN00TchKOT+orsWL0zCZRzacqudhGsTv0Iiuegq/XoTFbRb/ytKq X-Received: by 10.202.8.215 with SMTP id 206mr12051165oii.249.1517842952711; Mon, 05 Feb 2018 07:02:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1517842952; cv=none; d=google.com; s=arc-20160816; b=l/lh5q+8rpgTnYR+CorxmR92AvO2YeYt7Gk8JeGQ/YO1zuhfIqpG9tUhopVPLD7enK xXrfbgtY2VKMS3uNlU/hhUqkwfgwvfAghxWz9UbYz0vCfysQkaEdaZ/Phk4UnGPtTGji OKDyDqBOd9X/z6jOATsAi6giPgUDlRU1k1Kou/3YJU5eIa9B6Pd8PPgRdkF1egiRiIvp tB5WNe4cuDKmdUuGpT2EELlIJUVTXIbdZ026qevm7lq42tEZouZ1fU/qU850G8a8GYwC ufgjTG6o/B4Ip+BIaO4au9i3e/Am4xn9603Tnyq8lhTmpninQGLMK679dAMBh42nPSKY 8c3A== 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=JMRiQYB33B4G4qEjo3ZR2gUDIw0Be0NTRtTHNrD+PKo=; b=BI3lecdqfn5u3zJaYvpwwyqAB9TJiRz6paePilUiMvDt76gztkIDJvTwGWUasgyLa/ c/VTgciYh5FF4pUMzaYeeroRl6isG91Ob6STlKnvkGr6dSDzSpA1GWRhu3a8x3P1hwiq JJDRFWw0h00wfx7avdoS8h4GWDq/CP51PVfsgg549VvYSrHSIJRQTBFGNhY/gkzK1efp sSFx1la1iVQT4tC51oDK5m6+uP/36iP6dd8g0MiSlO9k+gNC0rDvqEwHrUood2Hs1FAz t1/KBNFsvIRIIu4TV99BeWIsoUG6nZ2/9A5o8wafi4e8XOtmZcG745U7Km0wNqgw4UWE 1nsg== 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 k23si4231109qtb.326.2018.02.05.07.02.31; Mon, 05 Feb 2018 07:02:32 -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 33C3861502; Mon, 5 Feb 2018 15:02: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 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 ABF2560887; Mon, 5 Feb 2018 15:02:19 +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 50AD26095D; Mon, 5 Feb 2018 15:02:14 +0000 (UTC) Received: from forward100p.mail.yandex.net (forward100p.mail.yandex.net [77.88.28.100]) by lists.linaro.org (Postfix) with ESMTPS id F289060887 for ; Mon, 5 Feb 2018 15:00:34 +0000 (UTC) Received: from mxback10o.mail.yandex.net (mxback10o.mail.yandex.net [IPv6:2a02:6b8:0:1a2d::24]) by forward100p.mail.yandex.net (Yandex) with ESMTP id 051CA5101F70 for ; Mon, 5 Feb 2018 18:00:10 +0300 (MSK) Received: from smtp4j.mail.yandex.net (smtp4j.mail.yandex.net [2a02:6b8:0:1619::15:6]) by mxback10o.mail.yandex.net (nwsmtp/Yandex) with ESMTP id ey2hGKmeHw-09TmFG4C; Mon, 05 Feb 2018 18:00:09 +0300 Received: by smtp4j.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id kq2GQHioPu-09K0GDG5; Mon, 05 Feb 2018 18:00:09 +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: Mon, 5 Feb 2018 18:00:07 +0300 Message-Id: <1517842808-14190-2-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1517842808-14190-1-git-send-email-odpbot@yandex.ru> References: <1517842808-14190-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 453 Subject: [lng-odp] [PATCH API-NEXT v1 1/2] api: schedule: add asynchronous order lock 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: Balasubramanian Manoharan add asynchronous order lock api. schedule order context lock can be acquired asynchronously using two functions start and wait. application can utilize the cycles between these functions to increase performance. Signed-off-by: Balasubramanian Manoharan --- /** Email created from pull request 453 (bala-manoharan:async_order_lock) ** https://github.com/Linaro/odp/pull/453 ** Patch: https://github.com/Linaro/odp/pull/453.patch ** Base sha: fa6d104f6031b9687ae5f60f87f5c2338ad9a83e ** Merge commit sha: d7a86f403522629f5e27827be080da34eec8d87a **/ include/odp/api/spec/schedule.h | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/include/odp/api/spec/schedule.h b/include/odp/api/spec/schedule.h index d493cc75f..54d0e1271 100644 --- a/include/odp/api/spec/schedule.h +++ b/include/odp/api/spec/schedule.h @@ -371,6 +371,32 @@ void odp_schedule_order_unlock(uint32_t lock_index); */ void odp_schedule_order_unlock_lock(uint32_t unlock_index, uint32_t lock_index); +/** Asynchronous ordered context lock + * Request an ordered context lock to be acquired. Starts to acquire an ordered + * context lock does not wait until the lock has been acquired. Application can + * use this call to potentially interleave some processing within waiting for + * this lock. Each start lock call must be paired with a wait call that blocks + * until the lock has been acquired. Locks cannot be acquired in nested fashion + * i.e each start call must follow a paring wait call before the next ordered + * context lock call (both sync and async). + * Implementation can acquire lock already in this phase. The same constraints + * apply as with odp_schedule_order_lock() + * + * @param lock_index Index of the ordered lock in the current context to be + * acquired. Must be in the range 0..odp_queue_lock_count() + * - 1. + * + */ +void odp_schedule_order_lock_start(uint32_t lock_index); + +/** Asynchronous ordered context lock wait + * wait for a previously started lock acquire operation to finish. + * Lock index must match with the previous start call. This may be a no + * operation, if implementation acquired the lock already during the start + * call. + */ +void odp_schedule_order_lock_wait(uint32_t lock_index); + /** * @} */