From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-DM3-obe.outbound.protection.outlook.com (mail-dm3nam03on0054.outbound.protection.outlook.com [104.47.41.54]) by dpdk.org (Postfix) with ESMTP id 1005B234 for ; Tue, 16 May 2017 05:15:20 +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=jSfHKJkS+RBkVKPqP45+m86gRy58b8dLb0Z8YT8KexE=; b=advkA/d9bLIFimg27FUKoNw+kicUcbrE+T/b4aWQcu068gdiZJ1Uc4f+oT1EWlFr7xhG6YYKx5aQK42Y71mVYXSHLXP60CJ2SSZun3ifjRwnHL/yq/kfjOmFCg/p+n7IxM84s0HOum8KhcHZ/kLvUHV2KBVdaHuj4unBU2DL7iU= Authentication-Results: intel.com; dkim=none (message not signed) header.d=none;intel.com; dmarc=none action=none header.from=caviumnetworks.com; Received: from jerin (111.93.218.67) by BN3PR0701MB1718.namprd07.prod.outlook.com (10.163.39.17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1084.16; Tue, 16 May 2017 03:15:18 +0000 Date: Tue, 16 May 2017 08:45:00 +0530 From: Jerin Jacob To: Gage Eads Cc: dev@dpdk.org Message-ID: <20170516031459.GA29020@jerin> References: <1494617137-8619-1-git-send-email-gage.eads@intel.com> <1494877214-6508-1-git-send-email-gage.eads@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1494877214-6508-1-git-send-email-gage.eads@intel.com> User-Agent: Mutt/1.8.2 (2017-04-18) X-Originating-IP: [111.93.218.67] X-ClientProxiedBy: BM1PR01CA0101.INDPRD01.PROD.OUTLOOK.COM (10.174.208.17) To BN3PR0701MB1718.namprd07.prod.outlook.com (10.163.39.17) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 215f360b-a675-41b9-ed76-08d49c09c874 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:BN3PR0701MB1718; X-Microsoft-Exchange-Diagnostics: 1; BN3PR0701MB1718; 3:zUFZDIO+YGDHWrfsAsRIYTDbAHjKhbUJcWH//pxUlMVm0dWFB8R7B1a6jRQZ2cyzJ4wuw/L75I1DnEGdr0itYylUstW/HT+Z3pN3fhwIUOPqwaNGWsn43PpQFW53L9DgAxFbhrzcwlNlTDUfoCuSgTeYJ7oaKNR/GMHgZIyi+zalAa8zfeYS9SFZtjtpbZ5EM21psM+782VHwk8QyZVsfoI6Wp02sUeOPuJLwp8IbiVis0nMkGqZ5KjhQeB8W3L93kBC549fbRjnffqdFMgkgDsnbNJKVhUD/WzvVOf96+Qe84RXwJ8ealP5Ag8j0gG8m1h8kIKFYlj9WNKrTdgvlQ==; 25:bP4tDktKPe6A/LEIlCUJpOu3nXL7p5OfAY9+dfGnfaNMYtiqR+puBUdBKvm1Y2/GJslvfJ0twRNE5kGrYrFOuNb4JY5GGxCadsrP4GX0z56wnb8kWeS3JPyFa8SN74giYVNSHvs3UKi2fDac8jcOmVUfPS4NDDHSFOG8ZXaSEa74uNyI30taDnydvLFpljyNM4nEIrguaPtkTTy/twARy1a5cxtGCvxk+DZIsWEalbitTPTeZcKxGVbga3cQuXsCa7N7g1+t8rg2JyCv7PoOl+ZyxudK0HaNezhXUqcwAlUEQPGIjHE6dvKKARfnTo71Z6/h3GlDIn1YW8QYi1WUAm8Sov5pqfmXltg6oiiEuNoOM6AZzKrouAcze4ZSJbbgkXN1VkFVbL/XKeOQpHbNws3j0ZkQTiJSmmpaJON28CinSqa1Wc0q46D7aT8xT/0tPvvIU0HmETMBuDrcmm5beWpqc7CZ9lpN7Eb5BazRMQA= X-Microsoft-Exchange-Diagnostics: 1; BN3PR0701MB1718; 31:aFQfZl0ZLjfMAbsxM7sqXPUxTlGKlSfov7wtJm2qS4zrqdSzk5y3CRklz9u6XWJkAjxlNO7JKdwybYFKLf6+bEiAQ/eVjPog3zXzrxkr0K8+lvJ6JVYk7UQ8VnTuxYOHgpu4CIzFaqUi3lVrKwsCVBLzzsrJMaPAFsfRHHO4hNT9OSiY+bKl7UK+ibmP1Vj/sHOs1uM6rJ0qNask7bmok1th5mOJSEmO6JrUVWGMWlFR1Ry/PZ02dZ4PHjGam2RDjmRtQFOCIHNRH84kSu4wxw==; 20:Shnz52BqfjVaRACw+F4X2TtOGXIP/0l7Ntfd6NyQ7iRx0iWv2sYpyhUWO3On5+ggP00PQpPmJIONUsTX5kCmIaOU8ltTDQeRA8ugfkkguzzYBBHrEyx3KP4CAj/kSDpQcXLfsSTCAu/14heo3r4G1uJBjxfe9tRBO2AYWhFWGcLVGaq25wYtEeKtKmowNLi9lgcCcZkKH14VIm5adKArD6vtLF6Cdgr0Te7udg224K9vNhRQhFLy03itamlA1bpKnIn80rhHE98EkKaEN5Rqt4AEf/JcKBYt6oYUkmy9fPFOJgrElS9aPogmYoswpMbdyYJiUIMV63M4zoUU2ZLO2gwO6AkJIlAkNe1CjJu99mcpJLRDS6O1bTm1bTxo0ymyJsNX9bzwlOzE1pBVex2S3o+nWL/tk4AhGdOh198V0MqefRlUF8FvlexKdAoKSnnHko9OKv3cAtwjbRhMFIIqcDf6fpB8ytcqRMsxKXFSmqDnghztXYchyvS293kyotm4jUl8222E78SZH7VC2hBfqUJVpRYmiMSQHRK/qYq/dWMKmVRVZyGEb4mKQH7PqzSBAmvyTtpkxvntTKxOH6ZpOxablIsfS4FHyDsB+w87hpk= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(228905959029699); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(5005006)(8121501046)(3002001)(93006095)(10201501046)(6041248)(20161123562025)(20161123564025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123560025)(20161123558100)(20161123555025)(6072148); SRVR:BN3PR0701MB1718; BCL:0; PCL:0; RULEID:; SRVR:BN3PR0701MB1718; X-Microsoft-Exchange-Diagnostics: 1; BN3PR0701MB1718; 4:h73IXj9tAThyTRrqDxYI3igL4anXL9ykRl6VkJbWCOza5WdKzDOcY1XNYeLAnmesfQowprWKwtecMpw87tiht0cOwP2YYhkwGe+ccaVt5qY46mX67/tSiGQlHcOWsG4BXrYSoNvvluRLG0NPYrm/Yy4ckvzJxI+W5wrdJy112ILA4YxPjYb06f2WZTrNc9snWAfmdAK2l93zYXb+PAXn2bqvvSdEhKTUhT4ttyNbRYCZuf236QYJLWhZqU8+IWkootr6tGGjUNaXFAB8xcwE9wYHtzHzmjbk+tlVXjARwPVy4am0kS+vVERTaTQmEdvlOWp/1hyz8FPacimc+BAwdwfHy6rOiESKk0VCn56eNXJqnWi0sGEO/ItjgZ6gg3e9kuEODU7MjgPewLBUi4CYtH/5omLhGiZ9379qBTsj64d13kpJBvVG2H2jiNquxqNe2+ESkw/qVFZSvKMIFEYRosmDHEf0Ccgt5HCVXzHyi+67A8usQLO8OjdYG4NfNI+C5DrW8JOIbZGfnEFiDc/fXj1+ZX561N0y0EHGXDm6IpIjCK5XuGr3YjWFezJ0GRoN+qkRHCDiMheAZSONM8/K2sOkue96JPE9xJMJu9c+cVgXIbW0hZzC/KWmAajWFlntQhLhd0XSVz3fCJrkSxU0YcOXA+l2NaTtjIIDk30CW3Gt/ilm12DTyeeq0m+UVG/V+m/GYz4ubqy6vGuPERjIXfwkUVFs6IaP6f9vUlAav5Eg3eT7v+dExeWpwM7W48ymvGKM9eAT+gO25EEbZRvn09rpWT87Ribh47AjScGBf2r0JfZBpp9ojnmQWZSSdJZf X-Forefront-PRVS: 03094A4065 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39850400002)(39840400002)(39400400002)(39410400002)(39450400003)(13464003)(4326008)(81166006)(25786009)(110136004)(54356999)(6246003)(2906002)(50986999)(6496005)(38730400002)(55016002)(9686003)(189998001)(76176999)(53936002)(8676002)(33716001)(305945005)(5009440100003)(4001350100001)(42882006)(6916009)(6666003)(2950100002)(229853002)(478600001)(3846002)(5660300001)(1076002)(23726003)(42186005)(6116002)(50466002)(72206003)(83506001)(33656002)(7736002)(66066001)(47776003)(18370500001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN3PR0701MB1718; H:jerin; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN3PR0701MB1718; 23:X+8R2bfRlgAEv15yJG0EhX8l8vTKsMBArbpZhlh?= =?us-ascii?Q?RUbYjn9mk395e5qpnV2hyhE4ibYvtX585t0iEZ5n8OT4UZlaEQNnNOOQe5fj?= =?us-ascii?Q?Ooes09a3sLdUqK71CPl9PFWxkzT3fjOfRZSxvv+t4yq8XVCe+lDlru7TXQaP?= =?us-ascii?Q?eQmbpugU6OQ5RTgBnVDuMTqfM+O/8NnbYM7QjU0L+LpFZDesNx1JDyM6+p0q?= =?us-ascii?Q?Qr32J6AMZlVrhm3KvtDVkN7gvU7rvSazvF4/xmfKEgTFMtXeR8IQXtxP+h77?= =?us-ascii?Q?GD8fLXIvF5SDFDVjLbuV7n7rh+dBai8jhrJga/sKAwgzBpv5tZxLHVr54TQ7?= =?us-ascii?Q?32XmeFF1QDeahVFO2o4BOEtR6yYXxwujAtAFTjDd5tkYXxLQFYajzaWqIWid?= =?us-ascii?Q?BpMXICIgHTv47HnJk5dG6yt30sByqRGTC2EE4BmR3ZWhSwK28CLgF/YcpLiL?= =?us-ascii?Q?u99ZZrjfMSdMpKyNCaH9Rue/9zUS5bVkQigx3p7P8HwoRW6EfvDoCqO+yCmA?= =?us-ascii?Q?2nZ/3vugSI/UN+dwqtTPhBZ7kZeM6hQp4dQNA3H17n5lrLsi0/WtOZuYfFF/?= =?us-ascii?Q?FT/MtMbelzY7UHsas1AMgVjt62rNPdtQBgXFY96DRRqHhapHTMTONwLjjTuQ?= =?us-ascii?Q?cNQAOI3o3608KfSdmpHBSlyxBN4PtTiltzQhjVt9i0rn862Kz7255/hFTf+C?= =?us-ascii?Q?AX8zxO26CwrwDez5Pbu3aDL9ViEMueSz4Ib5IwhK3gvu/rni1BbbazTEtdX/?= =?us-ascii?Q?BS+9vRmdCAiBKmuk7kfwfbuRbu+Wo5IAeZLdll7goN7yoR7PoBTIrkFYXUZe?= =?us-ascii?Q?zTf1WqLjaxzOZEX/eG858MV1/BdEyTRDxq2GY2ix+TxbarBLO2JrSei7TpSh?= =?us-ascii?Q?OHd55g0V4tyzgr15zQ852LclAm5K6tqhoWAMJfosuMxRjRbeTBpmnZDwp/h0?= =?us-ascii?Q?RmbB0K/b3/p8839cI9IMe/Jl6ANxepQ4IX2KY/KyOLfv6jTcg7CFCj9pWrss?= =?us-ascii?Q?smqs8dlKXHdLh+Mg5U4dzXcf/zQO2ZJ38LWT/eLANaJTSK/rdP6usKDNJQIQ?= =?us-ascii?Q?WC6h46WXrdfyRhgjsM7fy/pGIXV3XZ+IF3wyCwjXVhLHd0Id1zSKjCPANOix?= =?us-ascii?Q?7tjmnKWaxjP5TUAXszYFZZaoayQr6JPecEw1ugehm5c4SXlikz/xH4MY1UTg?= =?us-ascii?Q?x+eoiE2wHP+YCO2gfDRfJi2SWvhA2axGqhhE6?= X-Microsoft-Exchange-Diagnostics: 1; BN3PR0701MB1718; 6:sXdlG5zgpSvQrAOdtdkAqohtPTdQiMdt7VeauAsmDwCQC2Gt3goKX4twmSp5YMhf2i5qhSrmdVIuLG+8bd8A0S78iJEX2c0Mb2zKODRxEs/Dxhv3oQtGO6ccz45MjTXmsLPjDQIlJczpS8dRKZqbgAZzfhuFv8oHdBYRBc3Y9d2Cef+hyBhPkE1e0ULttENfBUrAKTeIDawIlrqegQoJXNxhGuhLFeYWqG4dSKgp0wrGomJKOHu2lK7i8nS1IEzLcJSG67uTwKCxHB4PuCNhr2GpjkAISk81odJbdxECdkN/Dq22+yebDIaRcdHPbUPACT9BbywLFHJO135I1nG2i5sLbvItZ+VAaEI1QAKWEox3hxnmUH65oxDwbmMkHTuqkZ9ZZnNJ4fk4IVjuLSVzGksAtjDk2st2v1n49UYUHlY9Jh8vnECrETYTNzBtL4RuVtWFQDrMUj/wiJXg30YNrdZZLUH11fE2zW3UBgIV6eSkvqiUH6EME/IzE+I4A5vs7Po/FJ+VKwZ3V39ndCLXGQ==; 5:g6vVpEjeFj/TLYDcFusZbnT5TO5oHJOXD+JUf/IiNeuuqXNvh2zYY+saxdQZO3qbifQI4EsxL3Cj4RXfOzJDJZ2YjdxHTo489Zg/Km2hvGHJLfa2l96A+19xLcvOD7HZOZhITe63Vil6l84Hwu8ZAw==; 24:94nScq5VaQT93iWVwRHiF6Qv1omuKTUdet+2TONrqyuzL4IukCI6JrPJIRTCEAIakiA/OFWBv7srCqIGkvYo0jKRG7Fho65FuG6kaYCqJN0= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN3PR0701MB1718; 7:rqu6i/IbBy/isKdV3+jJGHFIo8TlTNAmQnsTSwWQIQJ8Q/fBoVD7dYUq3ndPqE8dhYVTBPeAkstZ1YLQ5U1rMa6yhQ1WFgOAeHS2zT7sCFISSogQa0LRjwfC13HxNVo1+ptV1kPqxsDVrJ8Sxo/W9phFq3nNPh33+uVhizRPnfVQIh1kZ/JhIizWfnPLi6wSPPEXFEAGaiQntj/mt/sBlReaqvL7vX4cbJQUYi6ZX5C+Yk2PPBDftMaisOo4b4IRX9ZpJZ9ifmzPGTz4IOSPYxJk5vAfDHEftHXLXuOpewWw/OvST+DC4V03n9GzjgHppKhkQzDCYqfxY32SRn4YaQ== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 May 2017 03:15:18.6027 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR0701MB1718 Subject: Re: [dpdk-dev] [PATCH v2] eventdev: clarify atomic and ordered queue config 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: Tue, 16 May 2017 03:15:21 -0000 -----Original Message----- > Date: Mon, 15 May 2017 14:40:14 -0500 > From: Gage Eads > To: dev@dpdk.org > CC: jerin.jacob@caviumnetworks.com > Subject: [PATCH v2] eventdev: clarify atomic and ordered queue config > X-Mailer: git-send-email 2.7.4 > > The nb_atomic_flows and nb_atomic_order_sequences fields are only inspected > if the queue is configured for atomic or ordered scheduling, respectively. > This commit updates the documentation to reflect that. > > Signed-off-by: Gage Eads Acked-by: Jerin Jacob > --- > v2: Fixed doxygen output issue and tweaked the ranges > > lib/librte_eventdev/rte_eventdev.h | 15 ++++++++++----- > 1 file changed, 10 insertions(+), 5 deletions(-) > > diff --git a/lib/librte_eventdev/rte_eventdev.h b/lib/librte_eventdev/rte_eventdev.h > index 20e7293..9428433 100644 > --- a/lib/librte_eventdev/rte_eventdev.h > +++ b/lib/librte_eventdev/rte_eventdev.h > @@ -521,9 +521,11 @@ rte_event_dev_configure(uint8_t dev_id, > struct rte_event_queue_conf { > uint32_t nb_atomic_flows; > /**< The maximum number of active flows this queue can track at any > - * given time. The value must be in the range of > - * [1 - nb_event_queue_flows)] which previously provided in > - * rte_event_dev_info_get(). > + * given time. If the queue is configured for atomic scheduling (by > + * applying the RTE_EVENT_QUEUE_CFG_ALL_TYPES or > + * RTE_EVENT_QUEUE_CFG_ATOMIC_ONLY flags to event_queue_cfg), then the > + * value must be in the range of [1, nb_event_queue_flows], which was > + * previously provided in rte_event_dev_configure(). > */ > uint32_t nb_atomic_order_sequences; > /**< The maximum number of outstanding events waiting to be > @@ -533,8 +535,11 @@ struct rte_event_queue_conf { > * scheduler cannot schedule the events from this queue and invalid > * event will be returned from dequeue until one or more entries are > * freed up/released. > - * The value must be in the range of [1 - nb_event_queue_flows)] > - * which previously supplied to rte_event_dev_configure(). > + * If the queue is configured for ordered scheduling (by applying the > + * RTE_EVENT_QUEUE_CFG_ALL_TYPES or RTE_EVENT_QUEUE_CFG_ORDERED_ONLY > + * flags to event_queue_cfg), then the value must be in the range of > + * [1, nb_event_queue_flows], which was previously supplied to > + * rte_event_dev_configure(). > */ > uint32_t event_queue_cfg; /**< Queue cfg flags(EVENT_QUEUE_CFG_) */ > uint8_t priority; > -- > 2.7.4 >