From patchwork Mon Feb 22 17:02:55 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christophe Milard X-Patchwork-Id: 62606 Delivered-To: patch@linaro.org Received: by 10.112.43.199 with SMTP id y7csp1324798lbl; Mon, 22 Feb 2016 08:04:47 -0800 (PST) X-Received: by 10.140.44.38 with SMTP id f35mr35560447qga.49.1456157087790; Mon, 22 Feb 2016 08:04:47 -0800 (PST) Return-Path: Received: from lists.linaro.org (lists.linaro.org. [54.225.227.206]) by mx.google.com with ESMTP id k5si12892291qkh.65.2016.02.22.08.04.47; Mon, 22 Feb 2016 08:04:47 -0800 (PST) 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 Received: by lists.linaro.org (Postfix, from userid 109) id 4B215617EF; Mon, 22 Feb 2016 16:04:47 +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, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2, 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 F29A7617F0; Mon, 22 Feb 2016 16:04:17 +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 18E64617E9; Mon, 22 Feb 2016 16:04:03 +0000 (UTC) Received: from mail-lb0-f171.google.com (mail-lb0-f171.google.com [209.85.217.171]) by lists.linaro.org (Postfix) with ESMTPS id 7E05F6166C for ; Mon, 22 Feb 2016 16:04:00 +0000 (UTC) Received: by mail-lb0-f171.google.com with SMTP id x4so85374503lbm.0 for ; Mon, 22 Feb 2016 08:04:00 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=Bo/Rcf+Q0SSKpGvfCj2srKj8BLQQubdxFAxLnu00XZs=; b=FC9ScXCTId7c8FLrzrG5HcF14yvzgC4HPMBnzcg5yQifsK2NU+XrrGBr/HUIlPVrW7 zDD1J+fyDGlZXSh3z8ompbwdUKm+wzFeNaIJ/f2Fl4TASJ5kikSpidUzA0sXRzAtZDac wrm2Qb9SLZUKvCktjx718pQMypIpghcTjWOkQncHYZdSDPykgx0Pabkx9ma/VWSUsb9g HI3omAZxeqWvOFkHYYxmFw2RcrFiPRRliV439mlnvijxLcSdz85i3RyuFzpHp61AyBYH KRTfpWd8OGpq0PSjjc+MVuxxkM4vyn3mcFYysFtl2FbPfiQpAUb/+r9KGuNUefsfc32o HAlw== X-Gm-Message-State: AG10YOQ56bdNU32gXmTPfBQUPds9fCay1hKqx7ZLpSeitvd71a2ELEy87CmzkNMpIMGo2sQo6Ls= X-Received: by 10.112.17.5 with SMTP id k5mr10372230lbd.46.1456157039376; Mon, 22 Feb 2016 08:03:59 -0800 (PST) Received: from erachmi-ericsson.ki.sw.ericsson.se (c-83-233-90-46.cust.bredband2.com. [83.233.90.46]) by smtp.gmail.com with ESMTPSA id f184sm3470959lfe.6.2016.02.22.08.03.57 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 22 Feb 2016 08:03:58 -0800 (PST) From: Christophe Milard To: mike.holmes@linaro.org, bill.fischofer@linaro.org, petri.savolainen@linaro.org Date: Mon, 22 Feb 2016 18:02:55 +0100 Message-Id: <1456160578-8312-2-git-send-email-christophe.milard@linaro.org> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1456160578-8312-1-git-send-email-christophe.milard@linaro.org> References: <1456160578-8312-1-git-send-email-christophe.milard@linaro.org> X-Topics: patch Cc: lng-odp@lists.linaro.org Subject: [lng-odp] [PATCHv3 1/4] doc: glossary: defining ODP thread more precisely 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: , MIME-Version: 1.0 Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" Signed-off-by: Christophe Milard --- doc/glossary.adoc | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/doc/glossary.adoc b/doc/glossary.adoc index 8e514ee..5408b1f 100644 --- a/doc/glossary.adoc +++ b/doc/glossary.adoc @@ -9,9 +9,24 @@ control thread:: A control thread is a type of ODP thread. It will be isolated from the host operating system house keeping tasks but will be scheduled by it and may receive interrupts. +ODP instantiation process:: + The process calling +odp_init_global()+, which is probably the + first process which is started when an ODP application is started. + There is one single such process per ODP instantiation. thread:: - An ODP thread is a flow of execution that in a Linux environment could be - a Linux process or thread. + The word thread (without any further specification) refers to an ODP + thread. +ODP thread:: + An ODP thread is a flow of execution that belongs to ODP: + Any "flow of execution" (i.e. OS process or OS thread) calling + +odp_init_global()+, or +odp_init_local()+ becomes an ODP thread. + This definition currently limits the number of ODP instances on a given + machine to one. In the future +odp_init_global()+ will return something + like an ODP instance reference and +odp_init_local()+ will take such + a reference in parameter, allowing threads to join any running ODP instance. + Note that, in a Linux environment an ODP thread can be either a Linux + process or a linux thread (i.e. a linux process calling +odp_init_local()+ + will be referred as ODP thread, not ODP process). event:: An event is a notification that can be placed in a queue. queue::