From patchwork Sun Oct 22 09:16:25 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pavan Nikhilesh X-Patchwork-Id: 30669 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 [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 11FD81B357; Sun, 22 Oct 2017 11:17:16 +0200 (CEST) Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0085.outbound.protection.outlook.com [104.47.37.85]) by dpdk.org (Postfix) with ESMTP id 050571B338 for ; Sun, 22 Oct 2017 11:17:07 +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=0PMOShNzI4W1UFvKoQpciT74w+ZQQqjxpoU1qUw5i8Y=; b=PyPMsgLc9w7iCiQ+zZEZknXxR0Opjxr1vhhL8qXnE5Mrgr7NgOsEYAVXeOL9KqPFJdwMqVqpGuTkAYoUlIBMrwNzPuIczEWnZenHcdp4DRlJ76HyG8VFEN33GoAljRnUHaAydnyPlYM/6rlofdnNypJ+qFOEpNkHHSYDCGslLY8= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Pavan.Bhagavatula@cavium.com; Received: from localhost.localdomain (103.16.71.47) by BN6PR07MB3460.namprd07.prod.outlook.com (10.161.153.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.156.4; Sun, 22 Oct 2017 09:17:04 +0000 From: Pavan Nikhilesh To: jerin.jacob@caviumnetworks.com, hemant.agrawal@nxp.com, harry.van.haaren@intel.com Cc: dev@dpdk.org, Pavan Bhagavatula Date: Sun, 22 Oct 2017 14:46:25 +0530 Message-Id: <1508663785-15288-7-git-send-email-pbhagavatula@caviumnetworks.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1508663785-15288-1-git-send-email-pbhagavatula@caviumnetworks.com> References: <1507712990-13064-1-git-send-email-pbhagavatula@caviumnetworks.com> <1508663785-15288-1-git-send-email-pbhagavatula@caviumnetworks.com> MIME-Version: 1.0 X-Originating-IP: [103.16.71.47] X-ClientProxiedBy: HK2PR04CA0083.apcprd04.prod.outlook.com (10.170.154.155) To BN6PR07MB3460.namprd07.prod.outlook.com (10.161.153.23) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 5beed56f-5427-4dab-aa8f-08d5192daa13 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627075)(201703031133081)(201702281549075)(2017052603199); SRVR:BN6PR07MB3460; X-Microsoft-Exchange-Diagnostics: 1; BN6PR07MB3460; 3:Aek6P2GUcSqRBUxGohcQoq4zPWC7u3cFLy317UZCpNcEUbdynqklhvqaKYMBVGI9JS1PgZWSLXhHCqRy05EBNA98+t9mXI/sj+tBIXKDIlcRlwIl7DLmD7RW9i2/VY6TiVZdebFR3KzYeroMmBBU7WoOo82j5M8whpKbOtaEVPwi4nvfFnvFdg+F3OV5Gtd4UGrX6tgnVMDyAwZfuq8SDo5SSXp0l9bWB/4/ZQMmVo5UqYNvWRVqfMEeLPABdZe5; 25:bD1Sf0owIHFRw282mjhXGuJgglR32EQK/WZgq+VrwEwm2XoHFgKyI196F50SfiFeRf3UXOD/HJCVqYKW/eAlwQn6fsL16+k+y3s2R06nL0MSxeAjfxf8QEIquD/GlY5a+vzUzt6TulePRBCJnYl4b9GWrZxMJxxstqIHXURaK0pSqMRr/KsFHQqmzwf842H8EKCMjOXLKqlwtpUu/pzBFElNfGVAt0qXPOptroz3KGwL1DC0i6XYbUTfQN8tEdrS7CGrQqoo6tFWRcDDD1XgWclpp3sCpW6pWx7xnrToUoioXEZDqIsHEI/r5S1q7VrcaIO6Eh2igqAenxgOVUhTvQ==; 31:l4ZH7iG07bE28G/5FGCkBhr9GcrxUm0C4GPP+2gCkRef/BGioZntMpk9UTKIIQ++6Xvtj2QOxndhefnr6TYdGHmJYnpcuyFINn0Jwtx8DEuhMUmEFf6gdTo1mkE7P2vZBvbxojLvNotP1y3qRsDVfjvXOAGllbfeY3hI7Wwikn+DK7gM7rE81SjV00D53dPIyk7CaOXETYKEmZdVRZsGD+qiEFL1zdxyQwByMF7SX+4= X-MS-TrafficTypeDiagnostic: BN6PR07MB3460: X-Microsoft-Exchange-Diagnostics: 1; BN6PR07MB3460; 20:u9HZM5r7FhVNO6okdRNsst3Bf1T5/yU15Ps/vI3QUcylSQ1sxp4BC845YQwwBvBwxp1V85OFWENKyBYyyEjT/lKVsh7Yg8B7JJvhBOBxgPfLbB9wwS7jJ1dEgc1woi5+sYEm0IzJucK0YmNfs8Z7breKOv27Je9edGjBrE0/P3UXFm14atDXtxlP2dYUHCEzuOf6LuWFzOPUwUEykf3tZauQYO8mjRs4m+ku63kwdmbJyIerQVaLrtjufddb8fpdLxclUKz4OCURdeHLRsb2H90N+/kt58mIvH9JZKSEujO5yRb/FfaIIWU1DoCD1ZCUPEddd0aqQFAqbPJvpLHdk07wf1rT6NkhH1Sx7AuAaL7IEOKA98yiTUkX4mixayzfB1PpPFVoxov/oSTh2Z9yULoYBD2yBdHgruXj1PJ2XRVXUhnBp7WUnVxqTFBYjKy+Jg9Hd01lyNfdYCVzCntTQK1DAzDhmJHo6wC+SLzoOitpH4xxBkvUYsWYd4HpU8iXe551IX6/pdzSRxW+XGAEz4ptdXnLIxYgC3swpyGBPJhM+Ur3RoYtJ8DTreoig9wlobAHx7ItDDvXR5xWu0p03skICmzWqtZXjitCZsEKihI=; 4:NxHWVM+M9s5aHJf2+h7UD1SOIaL5ElCh/H/738L5WlOLYzEWrDuPxpOQLsAiENluQh+VAMQ2M1ejuVavKGQ4IP0lVs9TiZd+PnUjgfA4k/yi3xRZuuSGyhnr20lLRB250V1y+S5sUkuy45HzSodpJ4lI+/2GsIsYbVSPG3ijBYcGZWck8vx8HMkAUAHtasSgFI9RuM2RiKz7vLMHWhXs8CpZK0ljJPlePxBxUnlHJdcFyhR8tpje52AcT3YlctzDkWARgP/xx0AiWL4qU1xh4oweOkY4BOHQ8Z+4vPJhHIA= X-Exchange-Antispam-Report-Test: UriScan:(228905959029699); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(8121501046)(5005006)(93006095)(100000703101)(100105400095)(3002001)(10201501046)(3231020)(6041248)(20161123558100)(20161123564025)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123555025)(20161123560025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:BN6PR07MB3460; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:BN6PR07MB3460; X-Forefront-PRVS: 0468FE4A2B X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6069001)(6009001)(346002)(376002)(189002)(199003)(72206003)(478600001)(8936002)(3846002)(15650500001)(6116002)(6506006)(6486002)(7736002)(66066001)(50226002)(97736004)(101416001)(6666003)(2906002)(8656005)(305945005)(189998001)(8656005)(5660300001)(16526018)(76176999)(50986999)(33646002)(47776003)(105586002)(81166006)(81156014)(106356001)(2950100002)(42882006)(68736007)(4326008)(107886003)(316002)(16586007)(50466002)(48376002)(5003940100001)(25786009)(36756003)(53936002)(6512007)(8676002)(42262002); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR07MB3460; H:localhost.localdomain; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN6PR07MB3460; 23:XIOeQgEA720Cg8Nq5Dv+3a799AWGRrkViJq++jZuC?= ioIvujaX+zD2sUf2des0pi7h5DfBv9Od3/1ZK1PS2IKuO/2l4p5agt9BroZv8SZuvxlvSAKLavQvcAqwHbeOrrhnnJDm3g1Q3DhnCsATjEpnVnmD/sny2P04psPHGoYUQ4k6x3qyQ+IkDuTVG83vnHaRXu5VsZcPI0FIaVteHt2Tdwn6moleNLQieRSs8PuMROuT4xiSvvZnySFe8rOkinkEt211gCuXpLvDRlnLmqgoGr8ufSoj0ikKA7rBrqb8H1X1aTOfH3ytOO/1FeTEriiVvStujKnPC1josBXoOLHTiYQyLohHqY58wOA7w+qTQR3XOx+2M3YM+4vh/NW9s39nChJJkgblDUXBXIK/DT5hwSb9xVAMl7l4ji7kVfOd1PJ/ALCupaRN2PTw1qTpplxz4THUNVf+evxnXIvEbPoxwXspvHSjOr7Dm+BOOloZBrGo3J3XtspLcLBJmHtOrF5FqQk6GAeX5XxLOx/hgvL0vsgW7UNzIFqG5+jbzvsPlo+PxcUJ5eTS9Qzm8W42wTb6nzaoY5LKbZgyEOJ0dRHVIsuuOjuLlGDelzVZf5cZXjyU+nA6dXGpbFN8QwBU9W8X3dZQhPBDzbp1Us1fiTIKvmFSSGGxsa+JkxPIhRzHOq2lMtVPDp/VWiA6iOJFRdzjsOwE01j01KNEnx+FnsjYFSvbEIE4eBsKr9vxAeXJiJP33xYxlMwVPF7dkqYpmf18/jwJwj4JlVwfCLkNhEn60fOYU3go2R3MuMi0+UJFWkqdz239uNyb40ljm1KoiS2X/cRLz0rBUSWom1LNi7JbMJL40QfmfEXA/WI0qa+huSRyoiNIPGLZnkZJjGX/hpvY2RzNBUmFwGOmP92fpPIiOIyDJgY0XNWfwZry8ERxZVrUOEbEHrW+LaZFeljjcFNe3kEncUPAJ8yAk1y77rxboofLmWsN34DAJ5i8UWLmgblDKpqxl9TU4eMRmJKjxuzaaqPAiUGCbCGYyyCxu89B9iLuVRu8diW12+vqJVpOMkE1iV/AgEc4PT9qKMhIhrrpssH5MsU2yyrR9UwYFm1ASv0Waq0oNtVe7sRZAS2nyzF2DQi33ORMWtwq7n9DmfQwklSlVreCX8F2t2tmeKxpheLJV0uEd30NzDwQ04Xz7A= X-Microsoft-Exchange-Diagnostics: 1; BN6PR07MB3460; 6:PLoRzSS+RVHXtHq+dqVYhApRljoupmQFqjoi5CgsnylgX6qK32Jd+/+XI9YODHCA2XVrgzkgQUrGn8qNMOBWiBLdthfidJFWaXMXWNTxAHmQD402zcWqepymwMk0+izzPrx9gpvqCXH61NP7RclQ6PYXq3dm6Ct56ApvrGH4t2a1fP9uA4MY440tmiDpxxp+64YZonPXdod6z+3FLg9RBa9tmsDg4xuTBwts3/kPOyfch3oK6++Jms2HypTwiHIVaXWw4AywAZnHwxxnVMxcP6//6kFCcG/8D7avCq6jX4nU4jRlR382bgCSQLHVhVKVoU+bPbMeZ6MP8ySn95fuew==; 5:F7pQjDHeqwljcx1IYmuX9mHEUlvFDhV75ifNAlDYFh5i/2DmznWcaPIyl1Ikqlxad404TSq1WrLWI2mhc3QYuCarYDhde7pLiZpJyJogcpwrBlZ2/PTyCieCQuC1ca/wKl9g6YftibDNjOQcTFooeA==; 24:ffho5Hj7Hc9PepsXYjhcSr73/Vso4XlZN5roEEdTKUcEB3cqVFlv7vaGGX6ibCiEiLoYa4tiTmAl6gMtBemD3M3ovsX72TaLJbwZmcTOY+Y=; 7:pUmB5wBv+nqDvDAxe1HTIqBumahSpj6SEeolrtpyd5cIT9lWE0b+mGG9uPJvn/aoYtMuTLZIv7AvlVIbgzgyJQG17bnyi1/OmcsIR9nxWgosyAHavdVfYrTRh9yfe012APOSFG9AH0zX4DflRRiQPFauTeFqOpaBgunY+YsHBW4+bKlm5lOebUTn10T/x2KjTiLMIKIAfSIPWqOQcWczOo0l0szxzbDpbyQ0tk2CAWU= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Oct 2017 09:17:04.1056 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 5beed56f-5427-4dab-aa8f-08d5192daa13 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR07MB3460 Subject: [dpdk-dev] [PATCH v3 7/7] doc: update software event device 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" From: Pavan Bhagavatula Update software event device documentation to include use of service cores for event distribution. Signed-off-by: Pavan Nikhilesh Acked-by: John McNamara --- doc/guides/eventdevs/sw.rst | 13 ++++++------- doc/guides/tools/testeventdev.rst | 8 +------- 2 files changed, 7 insertions(+), 14 deletions(-) diff --git a/doc/guides/eventdevs/sw.rst b/doc/guides/eventdevs/sw.rst index a3e6624..ec49b3b 100644 --- a/doc/guides/eventdevs/sw.rst +++ b/doc/guides/eventdevs/sw.rst @@ -78,9 +78,9 @@ Scheduling Quanta ~~~~~~~~~~~~~~~~~ The scheduling quanta sets the number of events that the device attempts to -schedule before returning to the application from the ``rte_event_schedule()`` -function. Note that is a *hint* only, and that fewer or more events may be -scheduled in a given iteration. +schedule in a single schedule call performed by the service core. Note that +is a *hint* only, and that fewer or more events may be scheduled in a given +iteration. The scheduling quanta can be set using a string argument to the vdev create call: @@ -140,10 +140,9 @@ eventdev. Distributed Scheduler ~~~~~~~~~~~~~~~~~~~~~ -The software eventdev is a centralized scheduler, requiring the -``rte_event_schedule()`` function to be called by a CPU core to perform the -required event distribution. This is not really a limitation but rather a -design decision. +The software eventdev is a centralized scheduler, requiring a service core to +perform the required event distribution. This is not really a limitation but +rather a design decision. The ``RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED`` flag is not set in the ``event_dev_cap`` field of the ``rte_event_dev_info`` struct for the software diff --git a/doc/guides/tools/testeventdev.rst b/doc/guides/tools/testeventdev.rst index 34b1c31..2d045ec 100644 --- a/doc/guides/tools/testeventdev.rst +++ b/doc/guides/tools/testeventdev.rst @@ -106,10 +106,6 @@ The following are the application command-line options: Set the number of mbufs to be allocated from the mempool. -* ``--slcore `` - - Set the scheduler lcore id.(Valid when eventdev is not RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED capable) - * ``--plcores `` Set the list of cores to be used as producers. @@ -362,7 +358,6 @@ Supported application command line options are following:: --test --socket_id --pool_sz - --slcore (Valid when eventdev is not RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED capable) --plcores --wlcores --stlist @@ -380,7 +375,7 @@ Example command to run perf queue test: .. code-block:: console sudo build/app/dpdk-test-eventdev --vdev=event_sw0 -- \ - --test=perf_queue --slcore=1 --plcores=2 --wlcore=3 --stlist=p --nb_pkts=0 + --test=perf_queue --plcores=2 --wlcore=3 --stlist=p --nb_pkts=0 PERF_ATQ Test @@ -441,7 +436,6 @@ Supported application command line options are following:: --test --socket_id --pool_sz - --slcore (Valid when eventdev is not RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED capable) --plcores --wlcores --stlist