From patchwork Wed Oct 25 11:59:12 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pavan Nikhilesh X-Patchwork-Id: 30858 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 574301B9E4; Wed, 25 Oct 2017 14:00:18 +0200 (CEST) Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0057.outbound.protection.outlook.com [104.47.42.57]) by dpdk.org (Postfix) with ESMTP id 4F0591B9C1 for ; Wed, 25 Oct 2017 14:00:12 +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=p7dIthlQNd9GA3IfVNtUckYS2YpzTw8JRChu5EJXm9c=; b=HdYhoROfUaAl9+7OWNeul0y1zeJ72x01EFXEPDstAQn9jAeZONGHoFISlTKHkzDI8Do3Vfl1+tA54bN8QFPlsYN1v+88I28u2aSRyYtdivV6BKclGkiDxuKedWUQe1vcybVVco0tVH1ihWvVl/dOomoIIdMbvA1xxRmRMjghiGU= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Pavan.Bhagavatula@cavium.com; Received: from PBHAGAVATULA-LT.caveonetworks.com (111.93.218.67) by CY4PR07MB3462.namprd07.prod.outlook.com (10.171.252.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.156.4; Wed, 25 Oct 2017 12:00:09 +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: Wed, 25 Oct 2017 17:29:12 +0530 Message-Id: <1508932752-22964-7-git-send-email-pbhagavatula@caviumnetworks.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1508932752-22964-1-git-send-email-pbhagavatula@caviumnetworks.com> References: <1507712990-13064-1-git-send-email-pbhagavatula@caviumnetworks.com> <1508932752-22964-1-git-send-email-pbhagavatula@caviumnetworks.com> MIME-Version: 1.0 X-Originating-IP: [111.93.218.67] X-ClientProxiedBy: MAXPR0101CA0060.INDPRD01.PROD.OUTLOOK.COM (10.174.63.22) To CY4PR07MB3462.namprd07.prod.outlook.com (10.171.252.143) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 98f1ecee-05db-4367-433a-08d51b9ff171 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4602075)(4627075)(201703031133081)(201702281549075)(2017052603238); SRVR:CY4PR07MB3462; X-Microsoft-Exchange-Diagnostics: 1; CY4PR07MB3462; 3:jiaeBBsgtWIlUDbCTJlk2ZQPif8EUYnGxqhOAFZih1IzkVbLTDiodfja0WPX/OMOpUi/agSmwodFtYVcCnT0YBzW2EVsnl1q1UJ9BKThaDOnACJx8OtOzCnuWLUYXZX87u0QPG330E/VNjSgty0MmfDnW+/gvJ9RyZ+cVGRdOSLFir+vUZ4C3rTGWrJbsRuR2q2LLw/XS5TaGz9XG9iUCpYlwbBYE7HQVz8vaFAs/ZgNY0BKadUSwKXFXgB+sJEb; 25:jAkv3Z/VZRb55KCLLMtk6btlacOYrKFvpMqAkmw2C6Jl6EXOs5ofTPRp2WO26Z+yb4POP5t4jsGRBpLaS/x54V1gURPPXcBTp3QvCI7Y1fMVqXCke2LsO89pJTESm8HkEXWNHKLiarIpsl+UWcPlaEyngyUiHuDgSXMSJX+Vnh3y1ApcqaR0NKAlz5/kdrzQWO7mPJAJ94OrwHyN++zXe4rWzAKbyLkt/9kj55nxeXH/E5alyeiodIJdeaXmsgE5I204t8lnxHRHCqEQitoY2fOYEXLHP1IB2k4EB+7Dt1Bnmov1O9cfa7Ncacbwk9Er9hkQWTEoTLCTPu808KBEvg==; 31:uMX8dQVEUJU+dS+dtXOslesV9m7fnovcPWQaZcZrGzSNYir3viRT20thvzgOdz66aEeunJstLwIJsDCQ/F5z8gB/o0Qs4fDVfiovx57fvgaWpGT0ZxPQ11xllbpLAMvmskcwKNajzfhE93S9so5fR0TGz7qprMzzy0wkX68aXjFTzYFT7q2YUNNF9TTjqWi4XCcCw714rIfuMzP6t//38BmJ9iCpv8z+At3UjQHobOg= X-MS-TrafficTypeDiagnostic: CY4PR07MB3462: X-Microsoft-Exchange-Diagnostics: 1; CY4PR07MB3462; 20:jXM8ZRQaENzyQedW88emXfR6cVDuBib0naaZeyMWqb2t4B/Pzyo+LK+CMdVUxSfH2K69C7+IlXVRY/v2qtWoLdVhW7I/aNSU7ALq6R/0spce5C7I+Hn9Pu3L5kuOro4yNbs8UaVLbrtd/gQz4Fy39z5f0hmIqLOPaQMRF67osEPnqPMoggQUoONemCusaewK+vpGTzjbV3bLRlH3whu1JsvaCaCw6CoXmjark4fABNodujwdlNLbqxHcbXIzek6AurQCa2QbKylG2p3mqNJjXMirzlANJcJOWeBbB27O4Wow2gIpjhCiR6oG2eayUls5mrHk0jE++GlfdpiMOfLUJlwfEGxNOCTfC+sWQXTW+QV8Zv+MXdnJUpvcIznZ41esACfeWUy5DbUAcqSdBe+FbfiImEUhsVZnddBMqyDe3mwLadbaqrlcNfXKngKB8GoGBFCjc2lIJpt+o8FHtYPqgPWI5oWP//kn9enWGfNBtrrGddBkLLAu8fJNn6sYRa7YGQS6AsZdaOAETgRlo2vQ8FiuwV30ZIQApRGeKmbXuvIlwgBLAJWzJLbLFKA9dwCA1dxDUGUVKFYhiB1B24opF9CmlMM6W52kz3agvcALNlI=; 4:8LJtKt16oD7Nz4DH/wK/dvtJlSc6Tw2KUhfBYmgKj3SYBFDT6qW2Uph4b7Fg4DzVLbYn9Ta78C10JMd44As3LnbrkXyEKMkab1yFoL4KPspP7Q+v9KDd8mRtjhrHCOfj9hpBKFGO/aRANdi32nXvO10vYEOZNdFa2Og8eL1n4slg6ZHKlflyIEGoHKLWU8pInR76F+HbJcbLmEdMKb+jjHp/S3haDLWCWuR2b4GCkcjW0BpE1u84w9/5Id/AeDl4+Hkm3BY/LB5pI1OlpHZbIvNxK5To/lxlL2zqbKkGFnU= 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)(5005006)(8121501046)(100000703101)(100105400095)(3231020)(93006095)(10201501046)(3002001)(6041248)(20161123560025)(20161123564025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123562025)(20161123558100)(20161123555025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:CY4PR07MB3462; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:CY4PR07MB3462; X-Forefront-PRVS: 0471B73328 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(376002)(346002)(199003)(189002)(4326008)(106356001)(42882006)(8676002)(8936002)(97736004)(68736007)(50226002)(7736002)(305945005)(5003940100001)(5009440100003)(48376002)(189998001)(16526018)(6506006)(2906002)(6666003)(6486002)(5660300001)(6116002)(50466002)(76176999)(101416001)(316002)(16586007)(2950100002)(81156014)(25786009)(50986999)(53416004)(36756003)(478600001)(105586002)(69596002)(3846002)(66066001)(33646002)(15650500001)(47776003)(53936002)(81166006)(72206003)(107886003)(6512007)(8656006)(42262002); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR07MB3462; H:PBHAGAVATULA-LT.caveonetworks.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX: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; CY4PR07MB3462; 23:K2t5bdPyttMkZr1fmejy93t/3FGU4DTQ8obXMKPlx?= F7c/7F7H4PVX1E/n5hgAtGBFLyx8nL9L0thZZaIhfGQLIm0xKSkeookEu7lofk+nYDTscf++6FEeyRmN/odE3tmkH+C46qJAzcxPhAqehu/CJTzP+END0C5YiCDoV7NcOcJE37/X9d5PQAtqAhKeanwa1es3VBbgoSKQCvGnsSSQJVZLENediss3YhH67AHG/v2TPLacTnGCF71cGIKf96U9WPacVYSP6CGS4tZwyruaNP9KZma6GkW+9rbANJMlpu+lX9CmipsjKCyCEVkJpeqlcuBlg+T0UpD/2bnoWSHEiGN1/9+ofhHWpqlwQQ0RDjib8nSVjY1guSzGlAb1r1wD3ZrPm4b3lYuxNkYZiv1c51jQBbOGykPUZF6qA+yirrfVbrwALrbND4it07FwJMFdqmB0Ervl7aWC9mr+WRgut50gHQy/BXuIxI/7M28KNxhMGvCNUJJ5TS3ud0NiGSk15gfShiGEdVHakeP+2CRtVD72yfz3Kf+gAkkSL0zhIv4/piGFJj7V8ZdYgMXWSPuDRi2PKMjfblLoEZRKpx1WhtZbdG3rJK4+wC9rtyxGvtQ5YRJ2TtAggHs0Fndw+fapVLbaQPgd6mThj+ZTF+rM3NDGN07zDfa4LWl3/eZ6h8wf9lZCaGL3aJyw4P3ZZrc8XYoQbD66AEbbywegerJcTXnTCSK7LuNtHhvYWYdp27crQBrOIp0wNKleARNczkBcr6qkvyhrdIx1M5xa+WztHEcOa0FI2LbOt8htMpJrfsA/6OA15yOPbwlgD3Pj6xD01mkbyoCy17U8I+u0X44psNW4DB/1golksK2+cXHwdriwYP5UNDKkqvLTsBU3I2HJKK8QBnEcP10DvSdHxUSjvQvAsyG5HIuJ9jQ0P3lbAClRbPWxp1s3PNRc5qNxdtjMy3k5dgJWlmfu3vggKx7KjT91hUWk0xS/4V4+Zjnyl/M7eN7dMVMnXDY7rhljSHNcHiortZWqEmWzhM39xyNd/MDeVLkUL2vA5GFcz4C5GGtNMHeN3NywtU6rtUBGCDC7/h4gMCEVr1iJDAXxp2zHUNad+Jn6HYiTr2qjmuCcZoqqiQpU21tzw30URt+DJgOOajf9i1NpxOSdYmH7AMMEV6yMRV+ttV7roqJ81PnS8gluI0ANQ+TF19UDxIU8QoeD8e3UmkEzpK/Z+gXKAn4+w== X-Microsoft-Exchange-Diagnostics: 1; CY4PR07MB3462; 6:tq+lgwU4+phFkoaVcf6WIOcOZgiW6LygH9Pr1hri2ZlM1UiiYjWTYYK1H7b2cJObXaRLIWbw2ShZDq6R2my6xVtUO4DogAuTgttSuhKE+7Mg/Ci7x5ySKre1nyhALL/97sUblrR5QxS0bTMBuyXbGQOE+veMw8skr5Vkub4l5cbFnzlWIAN8+Y9vonXUnBEBG2j/fdCJ+w3nkt0qkRwZM2znA2gwlI6HZP8MjD6X/5NIy+ZF4XROMRBQW8JenqWyuAxMlcPvrQu8RUDot0pRYp++JREa1dvOCA9kBQO08CJBraELjiPr1fWs4a36OytaG02Zv7iL2eRBQ8X4qXBLFA==; 5:wGkIzYPSNJgxX3DUZP6Vj2dXNegnH4fyc9dIlkjoFu1TPYoYWDPFr0PudUt5EcNNXHfQSurmE23C/FyrYbWIsmbeQJTqTXNze/ONG1QYK+3MkL25qoR81XxKfz5USpaw4AEQalxDKPLaEeE3EZhJOw==; 24:yIGxQbcrLsfKuL6vLj3WiX4pdhL5Do/GoAxYKGVjPwBr4Lk6W842/G32uzAPpNJSxjcx7OodOC7eobV0VyeQZbEbgJHo7xKFG3oze3DDugg=; 7:nGFSF+96Acg3FSwi/8C02YYxFygLptWlYdykFvhuOsjetZYxj1R4NjeAalF+lcwPxoKfvN2zbigLbdsMMIDn3R2W6Hf5ymoEl4kGXiHhBQus3EQZRnffHRZSmVeLijFSQPwwuSAUwgLo0wiT4bIpCuIGmpptvpKxMrvEzha93hCbr435FyB8j9vPP8VDdmVXdrYeU3/R71M9FTr470FLhXxjbVQNSH56m+CiFfhdnyk= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Oct 2017 12:00:09.0556 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 98f1ecee-05db-4367-433a-08d51b9ff171 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY4PR07MB3462 Subject: [dpdk-dev] [PATCH v4 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 | 10 ++-------- 2 files changed, 8 insertions(+), 15 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..5aa2237 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 @@ -379,8 +374,8 @@ 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 + sudo build/app/dpdk-test-eventdev -c 0xf -s 0x1 --vdev=event_sw0 -- \ + --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