From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0078.outbound.protection.outlook.com [104.47.42.78]) by dpdk.org (Postfix) with ESMTP id A19D21105B for ; Thu, 30 Mar 2017 15:36:51 +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; bh=RqPgXmWkSz7soj35AVzIiyONoU0q4p1Xr2SwXKuQ1z8=; b=RrJa19qB9rD1k/8HL1zUe0mN7qXf8EFzr6H87jVh08pbeaYekI/or6pdPcJ0NudHbLbefB4aSvfl+HC5Yx2M5jIiDlmsAFi46i4FfJhTal3l3cIpJOhusSwjSCq7H4w2uep+4gi34tnS2C9/QzKCRTblofK/AzVo8MSUQKO4gmI= Authentication-Results: intel.com; dkim=none (message not signed) header.d=none;intel.com; dmarc=none action=none header.from=caviumnetworks.com; Received: from localhost.localdomain (111.93.218.67) by CY1PR0701MB1725.namprd07.prod.outlook.com (10.163.21.14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.991.14; Thu, 30 Mar 2017 13:36:48 +0000 Date: Thu, 30 Mar 2017 19:06:32 +0530 From: Jerin Jacob To: Harry van Haaren Cc: dev@dpdk.org, thomas.monjalon@6wind.com, hemant.agrawal@nxp.com, bruce.richardson@intel.com Message-ID: <20170330133631.kymfnawnzoq7uv7h@localhost.localdomain> References: <1489598478-149390-1-git-send-email-harry.van.haaren@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1489598478-149390-1-git-send-email-harry.van.haaren@intel.com> User-Agent: NeoMutt/20170306 (1.8.0) X-Originating-IP: [111.93.218.67] X-ClientProxiedBy: PN1PR01CA0043.INDPRD01.PROD.OUTLOOK.COM (10.164.136.143) To CY1PR0701MB1725.namprd07.prod.outlook.com (10.163.21.14) X-MS-Office365-Filtering-Correlation-Id: 55a72083-cad7-4f8e-cf50-08d47771d1cf X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:CY1PR0701MB1725; X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 3:hEu0wJUfGcIy/40RO1E2MWhe6P8zA/ys/EfVFQBcfxPFIhwiZBn1NpqAOVPNZcEJnbiVTIKcKeLIYGxvSSrqQ7R/wUxbMNdAkrIK2dOSK8tKi42a6ozDGkNMVSOHQ8PE0OVghlXLm4jznRIGDPZm1YM9TUhTkVdx9j1XhRpe11o5cukaq1jrT/5Tzt/fJqkB4WINQ7YI7cim7jHEyKne+O3H7/UIDvSmtZW5Q/5ZZz2xfRNjZ3GOm3EAWEgt27gGpgf5LQbFRtp52q5dQRFAuXwsWTKjSTgwQZOiApct+pYTxS74R1iPF1wEHGP0cy4tuDwjm9wXMvQ3KjQh6pmy7A==; 25:aDh2abqwPWbCXT3KB5MNsVooRWcKRZEBRcze9x0W27PKunzovIK1hqDBEiIz6uLm6RtR9ZNsRdJaRmvYwBVCFvW0kTtvgVzWZtZitxiqiVdg/2/ydxbjCoE+PUubmIqrj6B4vBL6YO6183CpMu3yjY6YfyvfG9oB2ZtGyVlAf6pUa9u32Paju70L+iQT3f+KCy4N/hOBD2FNi5xlq/yozBLRatiPf4R/nJMttLryA/+Cw7P39ys9rMCw0lqe1kCblkKejRHPH8OjGrlflZ1w9OjarlFQFezbsRToItRP/eoibSqHmcVODyDl0Ty6uuGk4aCfSZOKXYAzvkOiWlyWdhHhXSOVLAyf0cjKW3HvNXVcEMJzQe3Qu34SHcPy2qCeUhNjYTEy32SzGeXr1nR2YH2X3WlVWFl0vWRe1nQqv++Awnl6zF31Av+IotjVzHaTLz97q/c+cuXXEj8iE5RwmQ== X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 31:kPvoeLvKa/OaooOuHyh68/kgW8wb1cwvIzLfxvovZM5ZfNkqoNL/iYNwtdf5ZjCtGQTRMLtt4MODK+b2H7ucza/73qDORPixUEQzasvdW19qfkhRfia/jzRYxUzziUm01O6ouYXY+XALopjBow7dZPzkkrT6tO2lN71uxN3SlArtsn/x9PzGxTWHxEFbvh/o3d/lyKQm+zl5FaLOAh+Rh49vFpdjtd64L0Ow+99vifSLI9NYhCYd61s0j6OxsU9tN269hWcvs19/T36M1I+Xg08CZnkDaO8ilTqtk7w3RIU=; 20:oM+8tG90cTz/PpCeSLmqkTshTOUYqFjtUVdwzcaA4+qk+V2X+XqyB0r+aU9NkMcdqFG67y/ROzLnmiLw8AfMASsL3Ba8bRk/DT2X74KZktLKgoYNC30xZlVLiJKI2fy7h5tZIWGQxBEMnAlCII3lcD9+fxvU5TefQL6Eb25ULgWLCt3duA18sDechZgkzDQb6FIkQA24lXUQs8pmg9SFDfT/1sLFNNCU3CUog9BVa9wSxiQxhzJ/nePBY6oAbDR+m0x9c5XKaWucjRHamHPnbMTSp1dUtoKGP0Vaga7wyJdxw7HkPRrYp6klqLHZYo7v2eufSx5z6MmuyLNaVmxoHmZXiYV1yOLtpGUF2gsjeI6cct46VtMHr74xNoFkDGrWgcokOM0miqt98nu5Dhh3n73NHosyeoeqedM9AgSwpcb+iMPrhl4aemyXX++OrixKgY33wsmyT3KGtaeYl3tNPQc5JV2iDz3slKpwd6J8GhU5GUPDJCQfF1CtjnwCus4CC98QFebj5Gm96nBygOd4PbB0abWo2mMIc99+Umlg8ihn8Jne+rRG7ViG4zaxlomo/yp6n+iEHX7InT8gLXdHE210HxhXPdnsiy5riyA94j4= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(278428928389397); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(5005006)(8121501046)(3002001)(93006067)(10201501046)(6041248)(20161123564025)(20161123562025)(20161123560025)(20161123555025)(201703131423075)(201702281528075)(201703061421075)(6072148); SRVR:CY1PR0701MB1725; BCL:0; PCL:0; RULEID:; SRVR:CY1PR0701MB1725; X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 4:n9edLBaKWPO6ePrxBjldWBCbfySUhuRSErC0qjlnUPAGhlNg1N30SHyG2VkKA3A+qj6E89CvBQGKFe3IXh2dLn6xBTEhLpVY24SRXNRiAatPGC8Sk4GMg0zbOA2NcMxhT6wYb048yPBb5Sr6vycqMeCpe6a1yoZ/nO7Po9RMXza9NezCTVkwuNzrw4AADT584zN6ytWFAVPdapkh51cVGhQov7pGHfRvioonDsw9WewIofmxn0g/AFUUk3qiRNJ7bGMTnWQ9GCuxBJAPx0mCWUAxBOXKnc4YUJ5xhdVA4zlJ2CPJZgCeiBgxFw06TZ4vypkPIpYrccKNXKZkrmla7hDEv3MRnl51/RaOkjANozeo7BQU2AtvXfj41e7PrXu3UK+0rtFmx4SplPQ6y08hKXzeaUjsz6CrU3rPN2vBtRq3j1Dcgz8XR48Ee38tVhRLxiZRlqIApU9L/z4szhcyNpBOC6ZzSDTTwtzp/ktq30PnsJcnXgaQL784sy84YR/j08O5XV6Ir6tnd2Yh1hG1KoZlxE/h2x9RJLqLgn0ILTOYoiyiavMblglGJjmH7PSIIAEvxyHIl2Ida1bsuWGLE1xL5gZC+J0fMh4FjKPFkc2wlUJEYsjJHFXFYzcfuNbMP6z3OMItSD9jh6Y9qTFl+yJ05a+j12JTaBt3hYGKWTuB2foMQD8/JLsmvxwWwqv/TIS3+Z4CdEobJrr42s/8O27GeTbY15OGf9q800zvtwheyAPToXLxw/z44/2DzGpE X-Forefront-PRVS: 02622CEF0A X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(6069001)(39450400003)(39410400002)(39400400002)(39840400002)(24454002)(8656002)(9686003)(50466002)(1076002)(55016002)(3846002)(6116002)(23726003)(4001350100001)(4326008)(81166006)(189998001)(83506001)(8676002)(5660300001)(53936002)(6246003)(47776003)(5009440100003)(2906002)(33646002)(38730400002)(6666003)(6506006)(25786009)(61506002)(7736002)(50986999)(110136004)(66066001)(42186005)(42882006)(2950100002)(6916009)(76176999)(305945005)(54356999)(229853002); DIR:OUT; SFP:1101; SCL:1; SRVR:CY1PR0701MB1725; H:localhost.localdomain; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY1PR0701MB1725; 23:npZZ89zYIKvlJgX2XBQPkEDDor2gzx1mYcY76jl?= =?us-ascii?Q?wwaMJmSYPudeT/Ywy1PKJ1283rxnvIcLw112ITi6DCbrOKNWuCZQrA4k3h1S?= =?us-ascii?Q?42uNJJFX8qwr2so+rKq6Q95XyVkhe1Pjy1fleqi/EQs590EizuideTY9Dfjr?= =?us-ascii?Q?ntB/jllCtkSaqd7dSe8ABS2Vxb+HmttVHmKbrsJUGjjrUniIz+2RqUTFM9Tq?= =?us-ascii?Q?DLsAFrjz+x2J5MuSx0vGxP0erQ0VJlEerNaWi+GavxWkYfsLBuhAtylcQWz2?= =?us-ascii?Q?t0/rV5Bo9g4ccn/y+sAHYUkbfE/qWwmIeGkUt+zvBxrsfZpsHso8AOq0ZoMG?= =?us-ascii?Q?l9i9hZS8rpgL64qDxNeHMK3Id6TaW4Re1OQRPm78+VFCIZ1SzLiCMfLrUkfq?= =?us-ascii?Q?kkXB/kRH1pgjDgbi4fnS0tij5Rn7rBCBNFdB7HEPK2CE1R3VUwgpmGHIX+T9?= =?us-ascii?Q?EHOhLlWeqwepOgX3N0tfZyXT1dGA9S+xvAmc6jq+KC4nq/ParVI/jA1FEQMr?= =?us-ascii?Q?qK9IAE5nRxBHFRc6Mqmp7XF6dt8cTT3N0P9TwbhKSfrzRrPgc8FGT6fymp7d?= =?us-ascii?Q?/dJpTWCo7FQfgQQyPaxIEQ2t6Gc+Ec9eLhB7+qMHmeM3lh/PbkGhFrw4FTT2?= =?us-ascii?Q?sogzOgGEcJGIZ4LkdnPUPUvhRYFOmfdOaAfGoZqLwFe0cwGi9DPSKrFlP4XR?= =?us-ascii?Q?9LROH12CyDCgdsOFuB/NrbTGOP3LKtHdMpXsW9m90NoPRN8j5uMmmnS26I0f?= =?us-ascii?Q?yN+4rl3ckT6szz9jwt06LCvWamv9BmH4AMCCGp0AY30LVB+4bIgsNYG3VSUE?= =?us-ascii?Q?C38GuDH/rsJYObof1wMYmRmRO6/iagUGZ3j32H+bFoc26TWborghDgf0ov7d?= =?us-ascii?Q?MgnRb1xDxzUWZlcc2QxUanfxDPxEQZBhWuBeEdSVendpCKiSdAY7VuIpWfNO?= =?us-ascii?Q?kVQZiUbgKcNkgj3DW/oZ6cJWTYGwPBRjIOpCrMx1H68RtbqKFl6hQQRDd3bc?= =?us-ascii?Q?ykbYW5b79G13YrWHI+VCA6HlKdM9ijwXh3QFrBYshDjGROIY6RY0hnpG3kT1?= =?us-ascii?Q?LueD/PD4WOx0m/43gRunp8NKI1YAoBGnHEsLA5O0yc+ZTwuwtX1xsATPX+Rz?= =?us-ascii?Q?RBCIdfjlcJdfxC/Vbs1O0Hnl13xBgcVoU?= X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 6:/B6qT/IyBsfA9bmx0DvpLM9WKe0gcXxlqouQzu+bTeZD8pNvF7b/EMWUcSgomB3m9lGvb7EDZcu23sYWSQVzU645txmeddxskaMGKuKrXuuF2ikGWuPDBmIPOE4c5dRRUxvhBlLbrCOL/r3QNeZO51mVFrVqOmYUMxUjfHrxtsT1/69h4TU1OIHmYAZzA+Vc+yzYfwFxQjOw/WVX4Y48BYS93b5F/+Tnqul2sW/7YVCbFNev3xkLFJJ5yoyFHwwhCbeIXMAgOTHty8p9e0RF2nckORN9gtC7S5Ngw34ga/Y9D0WcoFyuXyeIVltSIRBzV/vahaF3TNX4eOX5DFyT3ueHQCipOHPUNiJhtQ0Cq+vajZsjPmPFpzMr3p6fI6wkuUuPgreSft8T33VesgP1QA==; 5:BLK1leZVfD/fkMohnvO8GqEM+w1g+Lv8yojKC7sEUGnmeH7Rqb3TLkfT6J1qdAp7gJhMysYmxXAmZOXOM1icS9bUqfZcDIN7GqIH5adG5FjoHK5miVDnSH9qT3RhJme8dn2dHbr8C3RDm5VeMPSjjA==; 24:kiiGRLBRYTOI4aoRxHaHDkSfBgWejXCvPx8APYqyzbUxQj75J7SIL8BrZfQqeSTprlQlCnNv6jVNYKrPs6esTiszwp7M39x3vinV1EX8rfk= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 7:0nlYcXGwPCcZJHTVG3PodiS8LAUN3TXvmHYurtfPDisDGE29v/RC4ga3CaPnq436JlbbhKdt11tQpKGnaOJJ6yrv63rqTofpb1J+XyJkNCtLamkQI0ogcSa5Q4oo2rs5BjnhbTECV1w/CowuhqVe96SLfzDueKcBReDJiX46TaZ9vCXdoF2p5NaycXQcWaKRQqa3VMZ60sBIEf+uL8XEsRCUi9Jyyu2Vi4ah3Pi6DgC+1ilFpdKAxr4J7KkkbQnsRR3eqfDIad207PgV+70qd6GQPrfYSog/t9Th/mkbwFCiGdvrZDHjo3ZIkbvK9fDc3qWteJp3ZnueU6n+wVs1Yg== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Mar 2017 13:36:48.0532 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR0701MB1725 Subject: Re: [dpdk-dev] [PATCH] doc: add eventdev library to programmers guide 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: Thu, 30 Mar 2017 13:36:52 -0000 On Wed, Mar 15, 2017 at 05:21:18PM +0000, Harry van Haaren wrote: > This commit adds an entry in the programmers guide > explaining the eventdev library. > > The rte_event struct, queues and ports are explained. > An API walktrough of a simple two stage atomic pipeline > provides the reader with a step by step overview of the > expected usage of the Eventdev API. Thanks Harry for writing this document. Overall it looks good. I have a few thoughts on this document and next steps of eventdev: 1) Need more use cases and associated example applications The initial version talks only about queue based event pipelining, I think, we need to add another use case like following in the eventdev programmers guide with associated example applications. a) automatic multicore scaling b) dynamic load balancing, c) flow based pipelining d) packet ingress order maintenance e) synchronization services. 2) ethdev integration is pending. There are some ethdev(NIC) HW features associated with HW eventdev implementations. For example, The given example in the programming guide has dedicated Rx and Tx cores, In HW ethdev and HW eventdev case, - NIC HW can produce and inject the events to eventdev. No need for additional Rx core push the data to eventdev on those HW - In Some NIC HW without SW lock, multiple cores can access the same tx queue hence the need for additional TX core may not valid on those HW. IMO, Addressing all the use case with generic example application and ethdev integration with eventdev would call for minor changes in the eventdev API and the programmer guide content. Considering the above points, I would like to share the current eventdev status and propose the next step for eventdev. Current eventdev status: 1) Eventdev specification more or less complete 2) Two eventdev driver implementations are ready(completed the review) along with unit test cases. a) An eventdev SW driver from Intel b) An eventdev HW driver from Cavium Pending work: 1) More generic example applications with additional eventdev uses case backed by programming guide. IMO, programming guide will be complete only with generic example applications.IMHO, we can add the programming guide once we have generic examples 2) Minor change in eventdev specification to accommodate ethdev integration and example generic application with ethdev and eventdev for packet forwarding. If noone is working this, I am planning to work on item 1 and 2 to complete eventdev work. Based on the above status, I would like to merge eventdev to DPDK v17.05 with EXPERIMENTAL tag and address pending work in v17.08 and remove the EXPERIMENTAL tag. Thomas and all, Thoughts ? NOTE: Keeping the EXPERIMENTAL status to allow minor change in the API without ABI issue when we address the pending work and I guess NXP eventdev also lined up for v17.08 and they may need a minor change in the API