From patchwork Wed Jul 29 01:56:56 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bill Fischofer X-Patchwork-Id: 51615 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-wi0-f200.google.com (mail-wi0-f200.google.com [209.85.212.200]) by patches.linaro.org (Postfix) with ESMTPS id 04522214B7 for ; Wed, 29 Jul 2015 02:00:32 +0000 (UTC) Received: by wicmm11 with SMTP id mm11sf1599302wic.3 for ; Tue, 28 Jul 2015 19:00:31 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:delivered-to:from:to:date :message-id:in-reply-to:references:subject:precedence:list-id :list-unsubscribe:list-archive:list-post:list-help:list-subscribe :mime-version:content-type:content-transfer-encoding:errors-to :sender:x-original-sender:x-original-authentication-results :mailing-list; bh=QNCT+jecVX1z4ASg9IR1t0tcU1AKABsDS5S6GBO1hBA=; b=IYPSqABqgqyYnCOkehuQrCaT4VEkwGVIpjjqQUgY+R4CRgBxUVL4i1zgJF2z2tQH55 +FsMjo15dyo72yhdv6JKKBABvAhHgHQhPJltK7U0jb5kyEa+aSzmQ6J+YA3oUyOWgsQR ssBwcVKIUqp8ezkde9wTHKnMG4Xcg5PFgWEBDce1684DyyBmPnAnhxJgFBPceuMYdpen fGVF6xUp8GDT9u49zi4PTlEV+j3AIKYOSJGkhb0f13W9McQF7Y/B1hZfoHeA7w7okGLq 2FrAfDj3CMbE7yiCeExHrSq0mBL+2yJIuxQIkigeRXOhO9sMQ/erD554Ozuz3eMo8jtH 02jA== X-Gm-Message-State: ALoCoQkuKsRs8DmmHi/pO82SycpuNmNXertHyqH+X4l0oGgMoX4potmAp2NAcf9fFSAxAp04roiW X-Received: by 10.112.9.100 with SMTP id y4mr14996280lba.20.1438135231289; Tue, 28 Jul 2015 19:00:31 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.152.205.6 with SMTP id lc6ls883697lac.80.gmail; Tue, 28 Jul 2015 19:00:31 -0700 (PDT) X-Received: by 10.112.219.200 with SMTP id pq8mr36099941lbc.110.1438135231075; Tue, 28 Jul 2015 19:00:31 -0700 (PDT) Received: from mail-la0-f43.google.com (mail-la0-f43.google.com. [209.85.215.43]) by mx.google.com with ESMTPS id pj6si20111584lbb.17.2015.07.28.19.00.31 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Jul 2015 19:00:31 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.43 as permitted sender) client-ip=209.85.215.43; Received: by lahh5 with SMTP id h5so79258822lah.2 for ; Tue, 28 Jul 2015 19:00:31 -0700 (PDT) X-Received: by 10.112.131.98 with SMTP id ol2mr36938458lbb.56.1438135230931; Tue, 28 Jul 2015 19:00:30 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.7.198 with SMTP id l6csp2462081lba; Tue, 28 Jul 2015 19:00:30 -0700 (PDT) X-Received: by 10.55.26.94 with SMTP id a91mr54294243qka.20.1438135229584; Tue, 28 Jul 2015 19:00:29 -0700 (PDT) Received: from lists.linaro.org (lists.linaro.org. [54.225.227.206]) by mx.google.com with ESMTP id 31si28532015qky.109.2015.07.28.19.00.28; Tue, 28 Jul 2015 19:00:29 -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; Received: by lists.linaro.org (Postfix, from userid 109) id DA78F61F45; Wed, 29 Jul 2015 02:00:28 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on ip-10-142-244-252.ec2.internal X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, URIBL_BLOCKED autolearn=disabled version=3.4.0 Received: from ip-10-142-244-252.ec2.internal (localhost [127.0.0.1]) by lists.linaro.org (Postfix) with ESMTP id 8819961F6C; Wed, 29 Jul 2015 01:57:27 +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 AC2D161F45; Wed, 29 Jul 2015 01:57:10 +0000 (UTC) Received: from mail-ob0-f177.google.com (mail-ob0-f177.google.com [209.85.214.177]) by lists.linaro.org (Postfix) with ESMTPS id 859EC61F41 for ; Wed, 29 Jul 2015 01:57:09 +0000 (UTC) Received: by obbop1 with SMTP id op1so98374032obb.2 for ; Tue, 28 Jul 2015 18:57:09 -0700 (PDT) X-Received: by 10.182.236.66 with SMTP id us2mr36435181obc.5.1438135029166; Tue, 28 Jul 2015 18:57:09 -0700 (PDT) Received: from localhost.localdomain (cpe-24-28-70-239.austin.res.rr.com. [24.28.70.239]) by smtp.gmail.com with ESMTPSA id n2sm13555547oia.29.2015.07.28.18.57.08 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 28 Jul 2015 18:57:08 -0700 (PDT) From: Bill Fischofer To: lng-odp@lists.linaro.org Date: Tue, 28 Jul 2015 20:56:56 -0500 Message-Id: <1438135016-22225-6-git-send-email-bill.fischofer@linaro.org> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1438135016-22225-1-git-send-email-bill.fischofer@linaro.org> References: <1438135016-22225-1-git-send-email-bill.fischofer@linaro.org> X-Topics: patch Subject: [lng-odp] [API-NEXT PATCH 5/5] api: schedule: revised definition of odp_schedule_release_ordered X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: , List-Help: , List-Subscribe: , MIME-Version: 1.0 Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: bill.fischofer@linaro.org X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.43 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 Signed-off-by: Bill Fischofer --- include/odp/api/schedule.h | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/include/odp/api/schedule.h b/include/odp/api/schedule.h index d679510..3f62c46 100644 --- a/include/odp/api/schedule.h +++ b/include/odp/api/schedule.h @@ -147,21 +147,23 @@ void odp_schedule_resume(void); void odp_schedule_release_atomic(void); /** - * Release the current ordered context + * Release the ordered context associated with an event * - * This call is valid only for source queues with ordered synchronization. It - * hints the scheduler that the user has done all enqueues that need to maintain - * event order in the current ordered context. The scheduler is allowed to - * release the ordered context of this thread and avoid reordering any following - * enqueues. However, the context may be still held until the next - * odp_schedule() or odp_schedule_multi() call - this call allows but does not - * force the scheduler to release the context early. + * This call tells the scheduler that order no longer needs to be maintained + * for the specified event. This call is needed if, for example, the caller + * will free or otherwise dispose of an event that came from an ordered queue + * without enqueuing it to another queue. This call does not effect the + * ordering associated with any other event held by the caller. * * Early ordered context release may increase parallelism and thus system - * performance, since scheduler may start reordering events sooner than the next - * schedule call. + * performance, since scheduler may start reordering events sooner than the + * next schedule call. + * + * @param ev The event to be released from order preservation. If the + * specified event did not originate from an ordered queue + * this call does nothing. */ -void odp_schedule_release_ordered(void); +void odp_schedule_release_ordered(odp_event_t ev); /** * Prefetch events for next schedule call