From patchwork Thu May 18 11:10:41 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jerin Jacob X-Patchwork-Id: 24392 X-Patchwork-Delegate: jerinj@marvell.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 162D32C5; Thu, 18 May 2017 13:11:23 +0200 (CEST) Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0065.outbound.protection.outlook.com [104.47.37.65]) by dpdk.org (Postfix) with ESMTP id 1C67720F for ; Thu, 18 May 2017 13:11:21 +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=CWGQj4mBAUdRZfJ0Te+B9oVKJwR3KSobtkCi2Xn7Si0=; b=RbKkivShS/dkmXhjzXftldPtTEiX66FK9JWRkoSApqWF5FbkIZtSvyFSf3C3nKZOgVelDYaCRhM2sIZ4mhQ2BAqEXRMRAn3YCjdQzbKMYjfJWUxYUDKk+XjdhCQlClFmv7+ylHzWnLPUmNEqs7IPlTamFjrMuQ7ag12ClaFDGCY= Authentication-Results: dpdk.org; dkim=none (message not signed) header.d=none;dpdk.org; dmarc=none action=none header.from=caviumnetworks.com; Received: from jerin.domain.name (111.93.218.67) by BLUPR0701MB1715.namprd07.prod.outlook.com (10.163.85.141) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1084.16; Thu, 18 May 2017 11:11:14 +0000 From: Jerin Jacob To: dev@dpdk.org Cc: bruce.richardson@intel.com, harry.van.haaren@intel.com, hemant.agrawal@nxp.com, gage.eads@intel.com, nipun.gupta@nxp.com, narender.vangati@intel.com, Jerin Jacob Date: Thu, 18 May 2017 16:40:41 +0530 Message-Id: <20170518111041.843-1-jerin.jacob@caviumnetworks.com> X-Mailer: git-send-email 2.13.0 MIME-Version: 1.0 X-Originating-IP: [111.93.218.67] X-ClientProxiedBy: BMXPR01CA0005.INDPRD01.PROD.OUTLOOK.COM (10.174.214.143) To BLUPR0701MB1715.namprd07.prod.outlook.com (10.163.85.141) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 3bd5d3e9-cf5f-48f4-39b5-08d49dde9ba6 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:BLUPR0701MB1715; X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1715; 3:qd2bDATthyHXxwZtwVOs4eofxzv0wBOmYLbx7G+UcJOv+uMMkio+ec3Lqly1RtoumtfVi4kovrmApdj/hsmTrq3O5Xn5XHjxzQ7rJBaIug4lh8BQbAsVLddR/Og79YxTHyItmp2KYcz/Zo+fYxUHAEYtqLK2h8U9ketPvFkFWKlYt7Mmwha6EkHLlUeeZHQ2CaTC1KiCurmagzZDaJpR3LoahaijdU1SVIyeKP1jt083DhmM97OU5QmbPr1i5qilRZlhASJdFq7S37VhrJv3fAyP7CJngFz4zbY63AN8wBMc6FLJAqvcAmHi0v72gIM+qAgvRQFn0kivDYQpEupy9g==; 25:sv9ahb2c2+IreM4ayzrW1mX9Ihoc1nj+JyRz3Zg5eCn9TLp27jReW/29Tf1Z7SppUGebLnlUqa39EyScxb639L0I/7gZWIYhNJbUEDhlUjnlNqBiCh1wSl06JVnpt95oYSBdPd7Vtuvoxhmo63sAFPkkARI5Yi13kUO9J8ycs3J27tob12CRRtQpYlqoLJT/JMTSdAJE+xH01BWYbS+9jtOnqw3sUgP37h6gc5v79oQ9HPDcT9jkQF38dQRdHBlIGeUUJQseInyzFjACahIJZk2q8KQoROjgcmpOO0fg4CCKloTa+zM7mOYUN9nciqJZ3wypBsKeXpZGN8Wd+4koH+qssPR9dURLfdtYldLKBbhj+IB7vOAPNtcsRL06+Y0DzoLGn1aLHA+K+nN917lKCFNOo53VmVGm1iG7im1TX148V880WBV7uQmoPG5RHFY3WuJMKThJ/ucKh5KWBE06y7c82QZE0UDU9fHfi+yR0dU= X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1715; 31:1T4N1OZ/s1Vqd72fuGl5vR/HBmXjYs5shfWQOUh6XMW74Wb73koj71cBTznjJt+gOb+vFn44/4P25sphufyE/vJVyZv9m25yZXtggsNslXQx6K9DCzCDSSsHvjhpp6OLyhDIztqyLh/UjeIfooKCMGpoLnh0gsnu66kqU11uFfSiKo9irDnVHCJ8F7Tz2EgBVso/7BOid2KnzV0LgpRd/FHzFn7RycLfwZBMOCsrD4E=; 20:pQIKpls5lI/PEfxYz6CsLxjHF3+xJ0tWHwENgtOnFx0mq/X1KnwlonRzYIgB7PwZnh/vjONBLPbLVYN4SWmCbrAGsObCGSaJoC2G9FYuPpXEA2k3oGTT1g+BVexvcxrxIwU8JGlPgUctQyb5vHM1glF8aL8gNa+xfMDlpOO7LRd4Q9tPvq1sty7jrLP41Xl7IW/bb1OEZt4NLPW0svhTnEnXlGbpWnF1g4D89iZyI9VA9fw+4Y8UXFFgnMHw5vrZEgze+PlM44l1517GFFxQd7Co+47M5SOhBAzoOxa4bQxr3N8LjcKq+8tiyV7zD6lkVo9EoJF79Awg11DzxhYPQUb+MD/BXjICB+lba/WZip1h5XojxmspJ9K0To7+tQqD0WvEAHL7mEYU2KYbdVQPofzzF2LZ2TS+TdeGslYolLtFdvpneBjof66yGblvwziIsuNC4PPs3UXyjYeBkkdZvChzan4XVvY1MElNIXMH1hFm7MQZ8KW3KUpEGxW6i6e3AEXvf1U9c9Bj/sWdwuKmRZG22pGRLu5dG882dEfyhlDuuseI0+oPLrhhXw3TvJw6uHdXweecKtO+9Hp50wnQRxPukUZHspM+VBvPYSljAmw= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(271806183753584); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(10201501046)(93006095)(3002001)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123560025)(20161123555025)(20161123564025)(20161123562025)(20161123558100)(6072148); SRVR:BLUPR0701MB1715; BCL:0; PCL:0; RULEID:; SRVR:BLUPR0701MB1715; X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1715; 4:RjK4DBoHRl7SBY93afDXzwdFvBMOFNpVP8rsz06PqZctKUzwAKxws4ufdlSm+cyxXw5jSdAyDGLDtWyNGkUTk3nVmOF9ajN5K9yZsUvuf9xw7UVHYC3KAhxc2NDeCpsuuHrF8o22UJEO0vSaM15iWguHDPGxqE68J7DXoQYV0H8PJXYznARUx+M3WuRPjxCXJOMrD95dtH7iqgf7IM6vJa7b8ZlPbaU+4W9XciHf5xpwe9VqBSXxSfuNedkC66CIgJC8QYXGqkyDlViEYWxL6VyQgTTUwd1vlcC5FiIFxZ9BMB11W0AJS7B2RWCJgZe5vgKBloMjg6CJTzSGuJ+57+Zd0GEs9+E9b8zHzIHVTgoNDidEtZI9A+Z/6ZBJKwttHwSJHLhJreIYoNYDMYUEvft8ogfYMx7cuT2FSoPRTptujZXlB7R3VP5NBRQcySBdg6m7O+X32g4aoLDRWkZGcydBLc+TCXDHchCDRZR9ucjZA/qNk+Vg27Pps7aWf/EgpiO7BSONr7iF5zybUL1Q+KTIo2HNbgo+7Caxn2DvFAdY/RnKSSUke9GYOtNxa1whVlTsRoVEv00xLr6IOTnVyqiimixe60xUJoZAbZk9Jwx0HdOJl4svwzp9Y5z3lxZ3cKFdPCUZ+b5+58N/cS/eqvHzFzv77dFy9aOdMzLOimr4nvC7ViEN5uxH1vlrFEOwqQMIGezf3Fq2AHTarxZZZ9zT4lRd+aclKq3G6vMWvmGop9Av+3hxzd0QkT9L3nFt35h5Nayn9xqD+HaydYAYMfsv7DTSvwAY8jqAX+IGa72udyaA79+ti8PhgjGQUUJ1 X-Forefront-PRVS: 0311124FA9 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39850400002)(39840400002)(39450400003)(39400400002)(39410400002)(6512007)(6916009)(42882006)(36756003)(6666003)(2351001)(33646002)(2361001)(50226002)(6506006)(53416004)(66066001)(7736002)(478600001)(50986999)(8656002)(6486002)(42186005)(8676002)(81166006)(1076002)(25786009)(6116002)(3846002)(189998001)(4326008)(72206003)(5009440100003)(53936002)(110136004)(5660300001)(38730400002)(107886003)(5003940100001)(48376002)(50466002); DIR:OUT; SFP:1101; SCL:1; SRVR:BLUPR0701MB1715; H:jerin.domain.name; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BLUPR0701MB1715; 23:a1bwWkBS4EXuefZl29tdERjmZiiAFuBzEvJNxcd?= MBviK0cf0b1Au65kU3348JbkEOhp7tZCORmP/4qjxHiKCZGfj6yo18OUUCneEWi2JqAezTaDRIp4Q6L9oE/kRt+llxS1EkztNND0N6X4Ssqv/nLzSVpdX/JGkpibpyAA41zKU35gvnkpk6ABIp6OI3wEAertyr9bhEmznhH1OD4FkW+dBGKsqDzlYHsBOKnTPBT1jJxZ9OBhcOK/6u13F1v6Y5ZECS1tzSDdBVX7OuUlthFgEdT1QNEGf1gja/o05R/nMYup7cS4f3JsgM9JPP5oX3uqQG6A7UKiZyMOiEqO+nEU+5IvK7KDiEgXHQiRCUnPQwAxwytOyLZ3zknl9CzPB10zVbG8/AcdMIVXT/XwHLTnVCkK4fUZSPpymcvEKZ4QMc9bGNoj5RSioMJ5p8Pu/fQoCa08LQ1ztDc+UbjDxFMWcjaNcFk2UJcGj/hzKI7jPu4gupdNMLmbDAFFtEgqq7nGns/fGTXCCTq8lTWjabMYn7ZnniTu0rI1c6I2eP5D8PaRFT2ixMFHIxpXn0+66ASyIZGgtjIIX4odSRLdvkV5U/YwnnvQGH0uFU8WLbYbdzzgMzpsp4qlyYqNiS3iuwbynzYoOht7n7Mh8yjKK8K27DUBqXhDTeXWzvnHmR+Bt0j9rq9m8KCDmM7ZyNp8kobzVQwG+MU7VDEZSXMf/pbYwBf9NCOtxZ1FCpodZD0SG3M2nYWPru4KvmwTETXpMciFVBthqZ0cIaIECZcKpeL6bjphIeC7lMClrlUhXx8QcHrJlagN0IIiTi9ZvPF139oLziykeaHX/Z0aSjf3cS4HDgTsFYrO3NUL3QHI9BYwnOCvLPMnbXT5UmshmhV/vxIqEmPFc1TmijBbsHyXQsQ6vLuJVMyFoqV85KJlKGyUei2hmMOPtjS+fCm+wbTq9VpjrD8zvDjzyq6tTgk2m0FHi0XtXVZgtSP225feu7yloLKt3HbcDPM9V4JRss58rfIVEMHhB9ZlFb5KJk9tFH1j0coHsvTtWr+suQCVJRF7AbDxq/c0vIYmi2Ei88ecBGpSC+q6OyLtd4t6/oVXiCA== X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1715; 6:acVOKfAlUAb2UMdQusOG9yEiSAQy0vaPbtwQQtIeZZn1t+mHezvsKxRUaJLK5ZT4LXDyeagKHHW2o1YGkgVYFC5q0csz0cO2ednQ4jLvrqhvOy+hc2zEwsk3lj4971QTvOkiRvjX4MvLAn617t0UO8K6t0qd1KQa1CATYKfsgLIvQf89Qu/4lFmtrVCes9C7Qkb18vn70DtIralIaLYbQs1yWoc9/oi4pZL5aPPtfPl8L3i0G9O7PEOZgfo7zxu/ok9s3qkMfW1ZqKOPKx5vPrJjc+g86WAYov3T+971XLH5ys+Ue8YErqynSOoida31o/kFPGlJRbAZrxqm1DMBkyYJd9a1kpqd6VAscNoNP+v2FCa63nGmfVpLlUh46ZGVl+AKHjdcKhLcYh+7opMj4PR/FfMH8OZ7poXXJpprICultO8zhfFcPHEeCL3VZ0QpS1H04qY4cOd3sSdATcj+VoknOqRd1BuUXevhsdNisUOQS/phgRXyDSDpn8ohgVZGsTOROTZ9RUN+dnsAxzEzEA==; 5:4B6G4DhskuiWmZKKkJ7zvDrTnlNI7hudpIEoH5dej+yjzpGMrM9JzjGNDyZotERxKxY1WFP4DDTOXVHmLKNutO1QW/RRWiVimIQzOW1lq1xOBXG46Hd3lbkZd4JQl8XjL1ffmwhbhoF0ibKROgCbVQ==; 24:TVdA860wXmsCm4dsu04z6FWwTrzOfy1hrWpLhheUGmRqUNxYDQ92XIb7Ruhkmj/kGsn5/WyjIkqf9JahBYIDjgDKkAZC9+Z8HFGS2zycjUA= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1715; 7:UbGA12FJ32rdogF5ysNuwViKNINDewuigdxJOWVSAL7mDxqrrq4cVuf3PSg+NleJjXAo4Tfq39/vb/R5WWfAbASc0aTp9fAp/EamQVUtqVno3a76Zvf3a/T/RxXguWfQbbl3QJrr6+DFt9vd+4FA0jkp/VkOIT8jCYB1dzqV7pFYPG9Lm57hWOC6MNsE476JQCTHeT9pB8yWMSKAmJIkL577l/JyJp0JrZzkWdrUIDMq07XR17QqEOqltg+5u1huEkyeATxuGhJXGQwA7JEGnk0F4TNB9IpEloPn2bzhV9Vp+9I2l/nYb/9lGER1hpK+vu7bQkT+GKvIyHD5vQZNBQ== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2017 11:11:14.4417 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLUPR0701MB1715 Subject: [dpdk-dev] [PATCH] eventdev: clarify the worker thread workflow 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" If the RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED capability flag is not set indicates the device is centralized and thus needs a dedicated scheduling thread that repeatedly calls rte_event_schedule(). Update the worker thread code snippet to match the description. Signed-off-by: Jerin Jacob Acked-by: Bruce Richardson --- lib/librte_eventdev/rte_eventdev.h | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/lib/librte_eventdev/rte_eventdev.h b/lib/librte_eventdev/rte_eventdev.h index 94284337d..a248fe90e 100644 --- a/lib/librte_eventdev/rte_eventdev.h +++ b/lib/librte_eventdev/rte_eventdev.h @@ -199,20 +199,6 @@ * operation. Instead, Event drivers export Poll-Mode enqueue and dequeue * functions to applications. * - * An event driven based application has following typical workflow on fastpath: - * \code{.c} - * while (1) { - * - * rte_event_schedule(dev_id); - * - * rte_event_dequeue(...); - * - * (event processing) - * - * rte_event_enqueue(...); - * } - * \endcode - * * The events are injected to event device through *enqueue* operation by * event producers in the system. The typical event producers are ethdev * subsystem for generating packet events, CPU(SW) for generating events based @@ -237,6 +223,15 @@ * indicates the device is centralized and thus needs a dedicated scheduling * thread that repeatedly calls rte_event_schedule(). * + * An event driven worker thread has following typical workflow on fastpath: + * \code{.c} + * while (1) { + * rte_event_dequeue_burst(...); + * (event processing) + * rte_event_enqueue_burst(...); + * } + * \endcode + * */ #ifdef __cplusplus