From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-CO1-obe.outbound.protection.outlook.com (mail-co1nam03on0069.outbound.protection.outlook.com [104.47.40.69]) by dpdk.org (Postfix) with ESMTP id C92C2397D for ; Mon, 4 Jun 2018 06:42:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=tNhiDtp/rvGrEW+tGbD81UDL6+yeceWQlHsiMJpes0o=; b=S1lJMjdLKjvFH4APmVpKEbffh7Jd8sPi7t4dgvFv9Fkf82p4P4H82GEHyQyNpefg2B2UgL9+XsrUFwshTst8QKC01tYqns+VRtEXwS2FH34ZD4C4KxcitUTf+22ETTGsWzFz367ihPsXyCxowrc4rfym6eBxWtG0Nx60nyrPNkk= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Jerin.JacobKollanukkaran@cavium.com; Received: from jerin (122.167.79.230) by BN3PR07MB2513.namprd07.prod.outlook.com (2a01:111:e400:7bbf::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.820.12; Mon, 4 Jun 2018 04:42:39 +0000 Date: Mon, 4 Jun 2018 10:12:19 +0530 From: Jerin Jacob To: Honnappa Nagarahalli Cc: dev@dpdk.org, harry.van.haaren@intel.com Message-ID: <20180604044217.GA2901@jerin> References: <1527798222-1873-1-git-send-email-honnappa.nagarahalli@arm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1527798222-1873-1-git-send-email-honnappa.nagarahalli@arm.com> User-Agent: Mutt/1.10.0 (2018-05-17) X-Originating-IP: [122.167.79.230] X-ClientProxiedBy: MA1PR0101CA0034.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:22::20) To BN3PR07MB2513.namprd07.prod.outlook.com (2a01:111:e400:7bbf::10) X-MS-PublicTrafficType: Email X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:BN3PR07MB2513; X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2513; 3:z2aKRLt1k2yo2qvfLFc3m8JBby+2CMZBVcvYVvcwSx62bR8cakiPawyPSiydlfbZ6gkg9G6vGmjMeDMASoNPF6aPZVmkthY8g8LWNYvccaritB/03FsHN2Uvf5VfdA6b02mYB0vn1AfPgRPMPsi9agH7i66y09a2k0jOYxYy+5I1wy56SrAHNZ1zxhe3Dd4+GBD4+QV+VDHx0VlvBTEoErc6C32IU3FF5HUswTe6AlDYcwqUylLgbxmrD7VZtp+q; 25:SuE5rSETY84PBRcwmaKtb4BpZUCtX+PHxqJxSyfkw+zCOHy5t4rBnMmOFwPwUbcdzbt0FmUR60meBvjMI+L9qpf8gKm2SWG4GGGWcBL+qTMTUu+smijs6peIbKIzdJqj1uW43pgxYHkKNKTVuQ7cpyr+TroCakMYVK4Lbme88staNY0wIBkR2Ypg/r/8+SkiPXpdSNWNudSGWztOi1C+DB5kjepknBItFL+vFeCK2oA7WciokTO4ursXRD79aj0XY3WyA3t0BhlkFm8QXraFgWMBZOPgKJWP33f3+KFPXC9vg/HnVmq01Ix4FTonulJlxU7HJmkUTnrQSXBOb5NFkw==; 31:M8JI3PuFu7UJwzs65V+W1jeigEIDzfLHHVUl31paEmIvjF77hCJvzfp2U3zbj38AfmwnnFNyfHlSDep3fsSFE3/+0UutqlkKC874cLGyt0FfNG0u+J9cA3XQSkt+9REwDFOUR7EfabJEOKjEgZ5z6Mlz2mYBym+QT+nlX/qdicpkjT8XfW0l/KJZn9Tvv/qq0/llVPn4GPhDh+7Vrj6vw0zTXfWO9oagDXL+Z6b9vy4= X-MS-TrafficTypeDiagnostic: BN3PR07MB2513: X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2513; 20:GTg6XO5fQlh9CTJzClQO6S91b19DskEW7KR/YXVi1IzVkkFmjjrGBCQUbWyoaobZdPmQGNCzJfyq4xAVv1czM4NuAhud/Wv7hOeqolCVayDawBx4xLRfYuL/BwJf1UQkE2RQekFflgWUEILmLRDKYgt+Z0WfTGYyKOKpnw6jVCMEQANmsmuA60s3BEZF83LlsMaWz0tCvLvuvMlS0OJmykiSGOkdHl675g2OHx2+c6znsfj7SmtAnF1ai5B5PJnax1/yingJryYdG7K6qSH2kOQLOyVK5D1zV+xy4U4vdtGK/Zp8LOmP0JIw7aH3hEDFfP5NZpWbbzbz76AsLP3Cv0lnWXOjkhnsCs5/agUZzKZZC59JCchbuoElx79L7BEtuzy5u6j9p/eg0T7FR6WIdxk2tgUMZx5XuCL+I4qvGp2Ddisu7YfbBg9ggUg/7yqMuQGpmcJW5Jw9gtaPMxZXe30fUcMjcm9WmKPC/Yrt0H+SsXO6xVDTmEwTBhHFPIaRNDN4+IgS7oFIrYql9ZHBn5BYlA+07FKX1UJfRtJgB4nJerLMyT/Jqoa6oM53Dyl7gX0VMTC+nXXMf/ollBy3icHUrLTpZYDX/4oPC9jpTFs=; 4:xChMv7NMaKn0v9pAFumXB7+Dyem52Bcis2yoic3dIR25kh6LeLxen3LM3t60KwFYKUsU+dQz9JIP6XICATH4JZvislMHay98vhx2NdR7yB5kuBPHtfm5Lot0MVHl5RhA7l1GALMIaPYFFDfOjqhPqAker6SEtrD8YfwqyoM4wu20RKiqshyBw+Yw0ubL3WgOfbMe+rQkbX72f05ycRjPZCF8ih0nB3NVzTj3vucsSniPRM1wltJFbzR/aitGKl19RtqKOB4Rq4Ipl5VBaaZ1LhgYnF+VF5fsU7HYBQkoIFeQPjUEmL1k8PEchqc3494z X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(180628864354917); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(10201501046)(3002001)(93006095)(3231254)(944501410)(52105095)(149027)(150027)(6041310)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123560045)(20161123564045)(6072148)(201708071742011)(7699016); SRVR:BN3PR07MB2513; BCL:0; PCL:0; RULEID:; SRVR:BN3PR07MB2513; X-Forefront-PRVS: 069373DFB6 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(376002)(346002)(39850400004)(39380400002)(366004)(13464003)(189003)(199004)(8936002)(72206003)(8676002)(7736002)(305945005)(81156014)(81166006)(68736007)(105586002)(106356001)(33656002)(47776003)(478600001)(4326008)(66066001)(23726003)(3846002)(6116002)(50466002)(97736004)(6496006)(52116002)(2906002)(186003)(16526019)(25786009)(386003)(76176011)(33896004)(956004)(476003)(486006)(44832011)(33716001)(16586007)(1076002)(316002)(6246003)(53936002)(11346002)(446003)(26005)(9686003)(42882007)(229853002)(55016002)(6666003)(6916009)(5660300001)(58126008)(18370500001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN3PR07MB2513; H:jerin; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN3PR07MB2513; 23:ViFOKiJK8EroVyiJeMd+p4fZZc/uej404Gnh82njo?= =?us-ascii?Q?CiSUPrisFPJ/pA1YHJX57fgRyAh3q+6a+tcr2qp2HPPIM9W9JGwA76h3abZu?= =?us-ascii?Q?I/K0cOl8j2cwAFj1K+aJUvrhtaS7br2T/ShK9/dTsTdCE+y5YJ8n7OWz0Vbk?= =?us-ascii?Q?NoMfEiMmAsO9We02QkI7x7/G2qdOl3GzkvXZ1BTaHszn+d49F5j9nckCWDwp?= =?us-ascii?Q?pfFwbZSDBFNS3uVaI+S2aIiQvUa0Zk+WiC/wkesSoEx869dtroD3XVnHqS55?= =?us-ascii?Q?w8sPQbVQEX3eYmb501LanyIaV6Y+2eAxPQIFnbZdDQu61xhpSTY7omksxvKH?= =?us-ascii?Q?3Shdw/oq+nlmH4wgVY/odAtOHPirV8TCZCu5jHTIufOwGuM0kkRO1FAXs/ah?= =?us-ascii?Q?BJK+p03e40ilCa5tV/GcEAsjCzYSLXRUQ7ULhDB6H+FXGXt+oJlZqIq/0L9L?= =?us-ascii?Q?FaORxnxMfixilddnkiIfjg1BVdRgakZihsTp/Ax3U/fUrEWbH8jmFaviXOZc?= =?us-ascii?Q?UzjUC4LUX85QuDbj4KYDpgMJEgQ0NKDcAp32qjOmLBWtFmr4f0hjlB+AtS5K?= =?us-ascii?Q?9KUhbo4U4+B+tFmNf2CWGB+lTmsZVXXcTeDxJ0IGf805jr/FEsHTU/sz11Zz?= =?us-ascii?Q?QMt47CKGVtsoGIkpIdBnRsESbefN4MZOSWO9eMUObQvI+Kljh4rGixL4CxtV?= =?us-ascii?Q?Lu5Ng2XWpqHOFSeK2IvJujQOpMIZ9Y7+3LlPzlNuOddYEg16CR6a1rmEfuOa?= =?us-ascii?Q?VnQIlzQw6TMJBmcVig+ZNmI397WO1scmoWMKHo3UEHYTG2zb9nQbrJ2CZ4iB?= =?us-ascii?Q?KU/oYFPjPyzgz4vzyFEJptkEkVIN/PRfwuI91V+nJJ2skoqqi/lUsuX6TNjd?= =?us-ascii?Q?qx9XyEwbFVFBT2WLn3rve8z8HtWEK+EKozVFnasCbt1ksETa/tKz+cnhOwxJ?= =?us-ascii?Q?li36TFuijDIp+HLhOU1vziQ+Sfq58aH8AJn31WOwNa5XBONR6HrlTPKZFe9S?= =?us-ascii?Q?rWIiCZWtSp2suS42gdtGQdUd9wO583BAKcHXyFnM1B4xzc9ywKFdG9Q0OFX5?= =?us-ascii?Q?z7a9FDBAg37qS1HvC55x8Kf9t/p12+bexO/PxvyNcJHmxaeq9GK3wr9d72pw?= =?us-ascii?Q?fxVy09QKaB+b+9LsvxE7jBNWe49aQjIKW8q51viptaiMchozOjiR84PkHA49?= =?us-ascii?Q?QfxCaVaFZqAjnWanXspQ/CfqrPG2c/oujFyuBJBj9lPck0LGKmplh567SyB2?= =?us-ascii?Q?Wc+SZI76elB1YQa09J/NxvB4pqp+ZzKp9l4JBi1rNtq4ru0EzZGqJmbJcCEW?= =?us-ascii?Q?feWwXTbip387jknj2eX1wIavikEsPaMFLeQt4zW6Chv?= X-Microsoft-Antispam-Message-Info: BbVrNxUapD1G8h8GJOX+yhk7duQqBekUvOlufFhtdtX7myBFN4Pk2qqfUomUyQcPOoC1zaMKdky5VTYsvCHw6GuSpIVd8zKteAAygAE5PlbzBRQ57onHYqEBdv5vHSqQC9LDfMktjYB9pGMugDN2KTHgNfDNZWCiz5EV2ySRsGQW+XMommMGLd1jwNX+8IAI X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2513; 6:sCmpm+GvhkIFaBjfZT7RX5wZDF1pw/O0ZOpOpd12np47OCwKgFhT0DilRmDqt/VySVfoiwKJkfg17n38mViAFW1ARc8HGMpbzLVS3YjCUm8pZgVM8RYB5OpjNmqZJInBlPWUmzHNAsd/tZ157w8SCwnNol4Vl4tmMlxOl/Cy7QySVnHQHxZ2iXsB6GKViA8jfjPbQJmZr3akGj5/TKeThpjqSoIzakk61SOCBBdNitsljhNOA5Lqbe9TlCp7sLBjs7eBTnId7NF6N4JjveLEEWBUSBvIW0umWTypBybQhMCmyDJfD74zcWtBdTz0NqtAekYacxw1+xF0Sk6f+oTIsvrQ78wnYablHrltUzQJ5K9x1TLcWjNl5BTnzRw4GOxI111ExTIwQj1+Q18eHQLh6eWa9mhOF9pffXByBc9mFhIL8OI5wL32Yz9cYELOhS+WwQ0Z4xRrK+N4UAU/tKEJEA==; 5:CLpYg6zC51D1VJfIUPCy6xVj0H0UTeXtcfp58Ar5qw402acagwaQ+AYtWsVS9irAtw9We8TGERLW/n1BfKbrSy0BKGwP9OrPaM896yZ9FtrPegSA7/z+Rr68be5Xx3f3BWshqquTph1UTwcB+UhYRcqrxa03tsRVdqvVl4EJFZY=; 24:VbPwIvS0caaLfSWryqlk4dJ8Ok2U/zsTxQEfVDD5n6WZfd5gFCmtu9TC4bz3M3hmm+hcTR4lAMnyJEDPaosj9Lq8uy6RER9xInDdvz4UoVg= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2513; 7:Jxz/EnMs9oFZdalcYCSmrfBvgngyeO2gH9ki60HkXiMWuxA3jmUcLil2+HsbY87vuqE7sxR29/+uuf7CB1IorK+l6ykCL77VXaOFoy7YJ+VBYtTma6JyzLHnlOly33Fg2JtDGwe/uvQvKQkiGIiHZb/KodqWd1c7/kSSQOCOBJ2J9eMBFe3SXozUlzc1ISY8mciFtws0uXmVQh3kMkiIxbdLH5AdTLDmVtkqW0sOM8Ew3gEl/De3q15DiuiCAoVE X-MS-Office365-Filtering-Correlation-Id: 6802363e-56c6-482c-6e9e-08d5c9d59b28 X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 Jun 2018 04:42:39.5635 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 6802363e-56c6-482c-6e9e-08d5c9d59b28 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR07MB2513 Subject: Re: [dpdk-dev] [PATCH] doc/event: improve eventdev library documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Jun 2018 04:42:43 -0000 -----Original Message----- > Date: Thu, 31 May 2018 15:23:42 -0500 > From: Honnappa Nagarahalli > To: jerin.jacob@caviumnetworks.com > CC: dev@dpdk.org, Honnappa Nagarahalli > Subject: [PATCH] doc/event: improve eventdev library documentation > X-Mailer: git-send-email 2.7.4 > > Add small amount of additional code, use consistent variable names > across code blocks, change the image to represent queues and > CPU cores intuitively. These help improve the eventdev library > documentation. > > Signed-off-by: Honnappa Nagarahalli > Reviewed-by: Gavin Hu > --- Changes looks good to me. Adding Harry for this review as he is the original author of this file. > doc/guides/prog_guide/eventdev.rst | 55 +- > doc/guides/prog_guide/img/eventdev_usage.svg | 1518 +++++++++----------------- > 2 files changed, 570 insertions(+), 1003 deletions(-) > > diff --git a/doc/guides/prog_guide/eventdev.rst b/doc/guides/prog_guide/eventdev.rst > index ce19997..0203d9e 100644 > --- a/doc/guides/prog_guide/eventdev.rst > +++ b/doc/guides/prog_guide/eventdev.rst > @@ -1,5 +1,6 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2017 Intel Corporation. > + Copyright(c) 2018 Arm Limited. > > Event Device Library > ==================== > @@ -129,7 +130,7 @@ API Walk-through > > This section will introduce the reader to the eventdev API, showing how to > create and configure an eventdev and use it for a two-stage atomic pipeline > -with a single core for TX. The diagram below shows the final state of the > +with one core each for RX and TX. The diagram below shows the final state of the I think, we can mention the usage of RX and TX core are API illustration purpose only, In the real case, it is abstracted using Eventdev - Ethdev adapters to hide the difference between various eventdev capabilities to Rx or Tx the packets. or something on similar lines. > > > Egress of Events > diff --git a/doc/guides/prog_guide/img/eventdev_usage.svg b/doc/guides/prog_guide/img/eventdev_usage.svg > index 7765649..b0792dc 100644 > --- a/doc/guides/prog_guide/img/eventdev_usage.svg > +++ b/doc/guides/prog_guide/img/eventdev_usage.svg > @@ -1,994 +1,546 @@ > License is missing see doc/guides/prog_guide/img/architecture-overview.svg file as reference. With above changes: Acked-by: Jerin Jacob