From patchwork Mon Feb 22 20:03:13 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Holmes X-Patchwork-Id: 62625 Delivered-To: patch@linaro.org Received: by 10.112.43.199 with SMTP id y7csp1448105lbl; Mon, 22 Feb 2016 12:04:08 -0800 (PST) X-Received: by 10.140.91.115 with SMTP id y106mr36538173qgd.20.1456171447944; Mon, 22 Feb 2016 12:04:07 -0800 (PST) Return-Path: Received: from lists.linaro.org (lists.linaro.org. [54.225.227.206]) by mx.google.com with ESMTP id x145si30933491qka.105.2016.02.22.12.04.07; Mon, 22 Feb 2016 12:04:07 -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 78FD561877; Mon, 22 Feb 2016 20:04:07 +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 658946187B; Mon, 22 Feb 2016 20:03:40 +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 E7F0661891; Mon, 22 Feb 2016 20:03:23 +0000 (UTC) Received: from mail-qk0-f176.google.com (mail-qk0-f176.google.com [209.85.220.176]) by lists.linaro.org (Postfix) with ESMTPS id 0E9146186D for ; Mon, 22 Feb 2016 20:03:20 +0000 (UTC) Received: by mail-qk0-f176.google.com with SMTP id s5so60239334qkd.0 for ; Mon, 22 Feb 2016 12:03:20 -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=lRCfL8QmvDmKKDDJJRw7qHjuOjJjUVFplcqMZDE6RyQ=; b=DCF5CdFQXmeOS/RDgWujIV9JPoFBFRS72GxvHp5Y9iNy8CHv3XWplMcX4L7SZ2c+cZ DW1ZwdEAHhchguJjhwEjekhshPXuqzehrFmG77xKMT656WSONTo6kx05hBPIL6L3XznR DUtsjtmhO6bFGo83qMPesZGMtHH90WqU7s4ta98Vwm2iFWf7ipyESAmn9y2OK0vINXZ5 wRfFdG+yi+TIsKZYhUtNqLzn7h5QKBV832BnexIaPJFMt7Kg0fJguD699BMplpOZc+V3 9uyNa//yzz/jPawvmCvBVOb5E8RZntmf2ldZr8LhzTJ+ddA7/hf0Gemq8zTU7fajOn4N edRA== X-Gm-Message-State: AG10YORJvg5s4HayM3Lkb7tqz/mEiI9k+dHsoemyVjFGNtjUaN0VsT/gwwFXhttOF8C2VyUr6zg= X-Received: by 10.55.73.6 with SMTP id w6mr36556616qka.82.1456171399764; Mon, 22 Feb 2016 12:03:19 -0800 (PST) Received: from localhost.localdomain (c-98-221-136-245.hsd1.nj.comcast.net. [98.221.136.245]) by smtp.gmail.com with ESMTPSA id c191sm10854545qhc.12.2016.02.22.12.03.19 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 22 Feb 2016 12:03:19 -0800 (PST) From: Mike Holmes To: lng-odp@lists.linaro.org Date: Mon, 22 Feb 2016 15:03:13 -0500 Message-Id: <1456171394-16384-3-git-send-email-mike.holmes@linaro.org> X-Mailer: git-send-email 2.5.0 In-Reply-To: <1456171394-16384-1-git-send-email-mike.holmes@linaro.org> References: <1456171394-16384-1-git-send-email-mike.holmes@linaro.org> X-Topics: patch Subject: [lng-odp] [PATCH v2 3/4] doc: use imagedir attribute for path 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: Mike Holmes Reviewed-and-tested-by: Bill Fischofer --- doc/implementers-guide/implementers-guide.adoc | 1 + doc/process-guide/bylaws-guide.adoc | 1 + doc/process-guide/release-guide.adoc | 5 +++-- doc/users-guide/users-guide.adoc | 19 ++++++++++--------- 4 files changed, 15 insertions(+), 11 deletions(-) diff --git a/doc/implementers-guide/implementers-guide.adoc b/doc/implementers-guide/implementers-guide.adoc index d68354d..db9701f 100644 --- a/doc/implementers-guide/implementers-guide.adoc +++ b/doc/implementers-guide/implementers-guide.adoc @@ -1,6 +1,7 @@ :doctitle: OpenDataPlane (ODP) Implementers-Guide :description: This document is intended to guide a new OpenDataPlane + implementation developer. +:imagesdir: ../images :toc: :numbered!: diff --git a/doc/process-guide/bylaws-guide.adoc b/doc/process-guide/bylaws-guide.adoc index e640811..1c93968 100644 --- a/doc/process-guide/bylaws-guide.adoc +++ b/doc/process-guide/bylaws-guide.adoc @@ -1,6 +1,7 @@ :doctitle: OpenDataPlane (ODP) By-laws-Guide :description: This document is intended to guide a new application developer + in understanding the by-laws +:imagesdir: ../images :toc: :numbered!: [abstract] diff --git a/doc/process-guide/release-guide.adoc b/doc/process-guide/release-guide.adoc index dab68d3..8816c03 100644 --- a/doc/process-guide/release-guide.adoc +++ b/doc/process-guide/release-guide.adoc @@ -1,6 +1,7 @@ :doctitle: OpenDataPlane (ODP) Release-Guide :description: This document is intended to guide a new OpenDataPlane + application developer in understanding the git work flow of the project +:imagesdir: ../images :toc: :numbered!: @@ -32,7 +33,7 @@ where a major release is to be made and applied atomically, this flow can be seen in Figure 1. .Overview of the ODP git process -image::../images/simple_release_git.svg[align="center"] +image::simple_release_git.svg[align="center"] Regular bug fixes, and implementation changes occur directly to master. @@ -47,7 +48,7 @@ cherry picked work so that it may be applied to master on release day, this can be seen in detail in Figure 2. .Overview of the ODP git process -image::../images/release_git.svg[align="center"] +image::release_git.svg[align="center"] === api-next === acceptance criteria for patches to api-next (path 1): diff --git a/doc/users-guide/users-guide.adoc b/doc/users-guide/users-guide.adoc index bbb53a7..fbd06cb 100644 --- a/doc/users-guide/users-guide.adoc +++ b/doc/users-guide/users-guide.adoc @@ -1,6 +1,7 @@ :doctitle: OpenDataPlane (ODP) Users-Guide :description: This document is intended to guide a new OpenDataPlane + application developer. +:imagesdir: ../images :toc: :numbered!: @@ -12,7 +13,7 @@ Further details about ODP may be found at the http://opendataplane.org[ODP] home page. .Overview of a system running ODP applications -image::../images/overview.svg[align="center"] +image::overview.svg[align="center"] ODP is an API specification that allows many implementations to provide platform independence, automatic hardware acceleration and CPU scaling to @@ -22,7 +23,7 @@ write an application that can successfully take advantage of the API. :numbered: == Introduction .OpenDataPlane Components -image::../images/odp_components.svg[align="center"] +image::odp_components.svg[align="center"] .The ODP API Specification ODP consists of three separate but related component parts. First, ODP is an @@ -360,7 +361,7 @@ The *Classifier* provides a suite of APIs that control packet receive (RX) processing. .ODP Receive Processing with Classifier -image::../images/odp_rx_processing.svg[align="center"] +image::odp_rx_processing.svg[align="center"] The classifier provides two logically related services: [horizontal] @@ -397,7 +398,7 @@ The *Scheduler* provides a suite of APIs that control scalable event processing. .ODP Scheduler and Event Processing -image::../images/odp_scheduling.svg[align="center"] +image::odp_scheduling.svg[align="center"] The Scheduler is responsible for selecting and dispatching one or more events to a requesting thread. Event selection is based on several factors involving @@ -429,7 +430,7 @@ The *Traffic Manager* provides a suite of APIs that control traffic shaping and Quality of Service (QoS) processing for packet output. .ODP Transmit processing with Traffic Manager -image::../images/odp_traffic_manager.svg[align="center"] +image::odp_traffic_manager.svg[align="center"] The final stage of packet processing is to transmit it. Here, applications have several choices. As with RX processing, applications may send packets @@ -508,7 +509,7 @@ Shutdown is the logical reverse of the initialization procedure, with called to terminate ODP. .ODP Application Structure Flow Diagram -image::../images/resource_management.svg[align="center"] +image::resource_management.svg[align="center"] == Common Conventions Many ODP APIs share common conventions regarding their arguments and return @@ -636,7 +637,7 @@ SCHED queues that specify a sync mode of ODP_SCHED_SYNC_NONE are unrestricted in how events are processed. .Parallel Queue Scheduling -image::../images/parallel_queue.svg[align="center"] +image::parallel_queue.svg[align="center"] All events held on parallel queues are eligible to be scheduled simultaneously and any required synchronization between them is the responsibility of the @@ -658,7 +659,7 @@ more events from the same atomic queue if *odp_schedule_multi()* is used. In this case these multiple events all share the same atomic scheduling context. .Atomic Queue Scheduling -image::../images/atomic_queue.svg[align="center"] +image::atomic_queue.svg[align="center"] In this example, no matter how many events may be held in an atomic queue, only one calling thread can receive scheduled events from it at a time. Here @@ -678,7 +679,7 @@ scaleabilty of parallel queues, with the easy synchronization of atomic queues. .Ordered Queue Scheduling -image::../images/ordered_queue.svg[align="center"] +image::ordered_queue.svg[align="center"] When scheduling events from an ordered queue, the scheduler dispatches multiple events from the queue in parallel to different threads, however the scheduler