From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0071.outbound.protection.outlook.com [104.47.42.71]) by dpdk.org (Postfix) with ESMTP id 9021598 for ; Tue, 14 Feb 2017 07:40:17 +0100 (CET) Received: from BLUPR0301CA0014.namprd03.prod.outlook.com (10.162.113.152) by DM2PR0301MB0735.namprd03.prod.outlook.com (10.160.97.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16; Tue, 14 Feb 2017 06:40:15 +0000 Received: from BY2FFO11FD042.protection.gbl (2a01:111:f400:7c0c::105) by BLUPR0301CA0014.outlook.office365.com (2a01:111:e400:5259::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16 via Frontend Transport; Tue, 14 Feb 2017 06:40:14 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=nxp.com; nxp.com; dkim=none (message not signed) header.d=none;nxp.com; dmarc=fail action=none header.from=nxp.com;nxp.com; dkim=none (message not signed) header.d=none; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BY2FFO11FD042.mail.protection.outlook.com (10.1.14.227) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.904.16 via Frontend Transport; Tue, 14 Feb 2017 06:40:13 +0000 Received: from b27504-OptiPlex-790.ap.freescale.net (b27504-OptiPlex-790.ap.freescale.net [10.232.132.60]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id v1E6e9R2011755; Mon, 13 Feb 2017 23:40:10 -0700 From: Nipun Gupta To: CC: , , , , , Nipun Gupta Date: Tue, 14 Feb 2017 18:12:41 +0530 Message-ID: <1487076161-7808-1-git-send-email-nipun.gupta@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1486739104-10953-1-git-send-email-nipun.gupta@nxp.com> References: <1486739104-10953-1-git-send-email-nipun.gupta@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131315280139279007; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(336005)(7916002)(39410400002)(39400400002)(39840400002)(39860400002)(39380400002)(39850400002)(39450400003)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(47776003)(48376002)(33646002)(2950100002)(76176999)(6666003)(50466002)(50986999)(97736004)(50226002)(189998001)(81166006)(8676002)(2351001)(81156014)(6916009)(105606002)(106466001)(2906002)(4326007)(5660300001)(626004)(5003940100001)(36756003)(305945005)(85426001)(53936002)(77096006)(68736007)(54906002)(8656002)(86362001)(104016004)(110136004)(92566002)(8936002)(38730400002)(356003)(81003); DIR:OUT; SFP:1101; SCL:1; SRVR:DM2PR0301MB0735; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD042; 1:w6uJeSfsDm/Ef2wRupGaevfYDWFKWqPlxmxDuTxIxN2C6oeER7lJeb5w3cCAGBBkFXE+CRQOo7KpuLPvA44IoHZ/kgwQWUGMQ2xMLWfc4VXUAYN5ETM+OLQGHFp+YU6hhQfwKKKjNVS6mWSRfTBCrokBYqZxXw1zLNwgrG2k5sRP2CzY5uIOUlL2TL6AnMeKfhknyLFp1nA/+Zmay8/m95bE43yt36RBN+GEJ61RuUU+CCFPwytnJ4RHKGJr6EPGd0Trtlt1NZ/b8R8P1fcAVKJa6W0ZV2G4JCj8DdSTvmExiKL+ymH3YYuQxPUhe7ix7t1zWaTrRca4ToLqhUPVNpYEfPcwBy91XTrlfidrP8J4hYYR8B5Dn5avVptNzCdOJC3qLNR6JxZ2RyNHfWKT9RiZAD+FArHjf+6dqykCq3DO/ee4WjfZgdL13ZCyGlWfLlGlMdPIcXPujTIP5rVxHwHEjb6j8NYTYgHM0ESsG5+nH4nJxl5K8wPIhsdpKrTPiPeopizY+rNfGegVLTCC1cUjajE1KQLh0YseI1whrgTrvOGM+U4VPkVPH3cIgVMFaJ1OJW2G+1lafTOHM0Pf42HG0swLxfbzTq1AfbHS395U6Ex2tjwMZUSDn8PGSrO7wU8xyKqcUL6JP20UVkwWf5NQiHdOjuK7gt/l6UdbZ74+gwJ8dZAj5efU6QBmpodV9DtJ8PGxrRt5VjR00nogH/sbLVX4VuVMfVmco8kSO1e30WnHdoPJNzYqzSiXpVUw MIME-Version: 1.0 Content-Type: text/plain X-MS-Office365-Filtering-Correlation-Id: ef7a075f-5b5e-4f6c-4f8f-08d454a454ac X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:DM2PR0301MB0735; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 3:LI7hRBy88ImRSFpQkea0NH0MCts92CM6kPjw/mebNhf+7rUKe78hufBi+6aOtRR+21maMGWmjBmSk8PUQSdV+ZgyupsCK5DXdv7gXy2dGr5JAG33EJDX3/hg0ZMR47UN+2CMLzQd7FZCm1GVhqW+WEQxReVDO49E1/u0qfQ+PkTDWJkRed2VVErQPdS7DAeALjI3BrSba9Z+AFS68h6imp9/Yq8SR5Zs6Xrd/o5NciVJiXllIjmwudS3RL121oAncfxjUjLB943a+MdKuY4VY0M4cNkSN5UwbAO7vCUj88PaKGtRwTI+Tldg3QLORPeYqwnuGmkZGkMvMSkpB5Di8CTVVy5FjHsf3doQBIQXY/EBwAcQrLuSrfbUKNVOivGN; 25:Tok/ckf2TLlOFk9iiaAs2DeN052ocpC8/fYmnFwkv9by5vcdijVz11bdy4krNzGUsMx5EQcBbwVvYAlBfaphvcLNlXen8G23bCcd9y+E5XK0+RQL25xocXD6FI64vJgxg1dipSYD/UvhFGVVonyK8eg6QwnnSdVXfKMOSo88oqd1LjGumd+VFsgN84lMoE3SzH/Cl2dv4waDAwkz9x7dj7peZ/gd7QORLjMmC00NRuG8NNL9wsd28Ix3XUuq8HXGsSfmsC9b1xA5ILduftprCNzSgyPbrFxdhaqUbca3gcEP1f1r7truVmvTv76ZkGiUN7CmYDyA3hOEspNkE4qRPk6pe1ROixbM+JisOTl7H8xArqwyJJb3Sls72xigL+9KrlcaLhb1KSMWRL2EEwhughecC1mgsGmcUuJ3uaezWtAji9SjurGBE2/fNeMLIPPUz/1fYsCGzNWArBoHOKqdCA== X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 31:tIe6Amai7TmZUtyA73cx4mHjD8+QJKDEEcPG87q+ZY5Xkdk5GrCBDCAAi1vfyD6bXV9pd2YWm+OuHwgHCxH2Wx4RyfEYdujEBbz/0KSuYNUMGCTdZlUCuamhf5/cCI97xb7JwfJDZFY0did6/kLa032zPbqJZ0xaIrmtkvSjHhmy+e8NNSD2w0ON5I20RVXeZ8EE3ztakzrutQWfZthlPDF3r9JnePUBIKVMAt1K719qL4Kl/USyT/1Z7VssW/Zq0gODHQvc1HISsur+kJ7L9A== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6095060)(601004)(2401047)(8121501046)(5005006)(13018025)(13023025)(13024025)(13017025)(13015025)(3002001)(10201501046)(6055026)(6096035)(20161123559025)(20161123565025)(20161123563025)(20161123561025)(20161123556025); SRVR:DM2PR0301MB0735; BCL:0; PCL:0; RULEID:(400006); SRVR:DM2PR0301MB0735; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 4:xQ1bgsTjyt/1urm7SBUw4BmVmh8+qnSixli2gq+x0ZyIsha/FhAbXxMw5rymwH0a2CnwIaA7MkZgL63wKzEVYJAyEhkUevLpnXumrsM61uH8+1xMwM7fnmKjq/zdXgZihp/XAwqAEcfuWFgVSk25aSKi5eFoah8Q30v13+9lElBxFi697rti0soISzL+KUVUYzT5X+dKc/kB23OIyue8qhu2yeJyeyA23MNJlBW3a7M3ahAI/5lV6KEF2IZ4YAJHefGa/+OqsFBVX07xnIeQsbosNBx3Moc4J/Kb7l8LFGlQDvVmLW3PVIiN2iKedltGZvEBbBE82oBwHaKlBKzDkW3XmO/iQH/nfDAze1QwnUA99Bnv3h5j9gRPTXWPsM2oYEOgws9AaAnCsOvLh3gv9FMYtCfgBhK1MTOVazQZrfIbocCE7V95WQK+oIHpUwG3LhcvtQC98uCBwM8aGPyctR5cVCFOvR1vsX0Bp+K7VF6XW9qOfO/kcXGFko86aCHrrnrtU/Y2tMO315Ehsc7CXszWIEDVQQVAb6r3qSTqhDY+5MPP6hYaA/KFn2Xne89+OrVwn8KLT/ri/VmzN3TJGHSFCX+ELIN2Qiw7oIhL55GhqvwgYtnF3cPuKgP714ENVluviBaz6bL+aEzdJOjU32FBDIJsrsgTPapnINBORT7c8QqqJRe2S8s/K5kuG2z3BuVpmJzJwaPQGJCTZcqoEYvCi0fS4dT4122s6M0L1bdTfZn2BidVCHBudPkM46SF X-Forefront-PRVS: 0218A015FA X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM2PR0301MB0735; 23:BPi1lBmJnCKl0P0/8LihW/F7rHnEZAOUyWA0vXN?= =?us-ascii?Q?xMNKO0pOpxf16MHlgOyepK+LHx7muEvHDeGElsg6HOQA7pPVcMAuLpEHsehG?= =?us-ascii?Q?bmwuUoVhupV+Q4hFcPP/1NubFEPzSgPv8gb+pzebfEUEy85umKauWPeZU9D+?= =?us-ascii?Q?oMnC0VAlVQsEyDH1fCWweVKnoa1zq4AhmsqiuTVt379erJRhom0p0KixZg8T?= =?us-ascii?Q?hPk+TszmmoSTli24T1lmCzTx5uZQuulwgTRp+0FBqcn+p7ep3IfEwU7gKhwr?= =?us-ascii?Q?49rniIp9/T8s1QqigOgUN3XEGgVkbOrHP/Qm4U7zEhDXG8IwII/H3gvCvyEZ?= =?us-ascii?Q?a7fPS1lQyMhB3CNN3aDZ3psq/s/L3+Sh9P/WXqMwmVBtSdvr8E95sB0zOgDC?= =?us-ascii?Q?x2y+gGYNXKbwy0j7Oe5isjf29E2E2Ns04LxHQGOJtR+41XIFICY8W8RgQOFR?= =?us-ascii?Q?c9ndm2TFLdx3zcSY2uoKy6ikCjgo3cgUa0OPFx5bUWQWAR0C9QcwjjzWpNT0?= =?us-ascii?Q?xuOAIY0d6xbz3u0ckW+U7z2a4wy7tX9ESv84nyuaC5bWO7cF9YOxojUBT19m?= =?us-ascii?Q?hDo6IXOvTiyz5dH0Rcb8LXpUH1L/GdhIvBTgOZrE6cI6alTT8Cs84yw5E1wa?= =?us-ascii?Q?0u2A1+AkNqxMNTD34aeXblTyVM2bgilx8h2PfK33PUGTHQaTZf6CV3dfLnoI?= =?us-ascii?Q?5TXMh6QZEkGMX6kbvZxslzYEvy+TvWVGUSDJAxBGDq2TMhjlmsmkkzq/TCZU?= =?us-ascii?Q?J0Z10w/rVKLixyMBxYdlDOBIM2KZ9mg6NYGGi+nRqdXLtJNUWMVWYHTfKrhG?= =?us-ascii?Q?MnTemV1LIckVVWHyG+ujXBU4JTgmQ2vUYXS8z/9Wt5UGmc89Q2WaEpLU9jEA?= =?us-ascii?Q?B1n0TrzoqA7SR7SPTrCBiH3Rgo+xQCWvgkzf3+1TVlUnLvYu4PC4caWmp1xr?= =?us-ascii?Q?yp9vm0r2akGrKtHTS+ec7AvXuqLIThon+jCdaofbqB9eHOLUgHiU+L2Y8BOD?= =?us-ascii?Q?YrC7mAp77UroaWVwuDMmmy3Dd6F02zXlbH2uwo9hXP9dytckgqO5NYMqtMK5?= =?us-ascii?Q?RLfiGHeANNUq7gjzMG5XjzAGwoU2Xr5ddgw+8JfHEIk6y46FEjWnbj7gRi8Y?= =?us-ascii?Q?1MF5GIQu4OZARt/PVBAK8kWHziK5DsOhnZJJjvOJvREfsIDvOcrUCE+wRdzG?= =?us-ascii?Q?PG5LhXS91vlZ+ZsTmsWa0VaOW2eec3qHicXKj9FG/lL2CrZB/0GVZSYX9sDk?= =?us-ascii?Q?wISOTxc37bS1/qcVoRjDw1tnzjqgQU0+2rmFkbpHrEDGTLkPT1N+BFlrTRVe?= =?us-ascii?Q?jrqXdy/X3XZFOVaXo7+LpBuWPz0SD6eSUb8PJ+T94Qtkr?= X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 6:I1RZhJTT1EqgCy8cqrdLHVaKMzurczUooCu3aqtFXAi2/QGmoT4UVzi5sJgFo2aiUCcgfkAsQ9VYP4VWSbR5DnN7t8547ve2nrIFHy/4eaYCMWb6Gu0Vp+aiViTogVWpXs1/f5D72ZfaHCBG1i6Rwzi7/qRieaCIUIWT0IgQl1hFNnQY6mZdhNCO9jVpTNv2mnEYY5iQH7L/XoQEghBWf7d/QNmpNcscXCkBiczBxK+4KmScZ7XKgwJw/9gcc02awsn8vSNBMu1fczVI1vG7Lw/ZQ9vIz9uLEc+SQwg+DWXjTOPaXRRvrZU2jdJXL6Xqc/U0pKZEvHIwtO7pzVWu+xvGpjPX+K2CF33klrCvmWfHpZ9llA8pt0Jc4EOUFzMhTZKwAL8T4pGvWSnrnVrrUZiJWwoaTrGrWfFacUglEYQ=; 5:+c19+aqB8r3lyxBHZWRuPvmxtf9DTXSpUwTNphmfGJMMko7caECBIA5Z6dyZW6kAN7K13nfo5zyxJVBQuxCzZ5NjQ5dUNmhXYMhI7hqxZoxlJPaZtwzKiRt8UeY7EtJJjfQZDpw8PLYEZdLtlAe8FeGF5mw+AapJdWBJ2efOWpmz3mxesLoYoynqmpoy7HMR; 24:Gzp5DL0tEm4rOWzimpADEAfND7ObZVhI10cqrusdEEfed41P3dX+6h6abkkd9jGgz3dVTm2l2mFW5iSat6HQdsTQfYFJ2cVaO58Vo5QtuTw= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0735; 7:DkNTxs2K/XCc+XFJ1+dYOugNyTv4wcfLKuJ2se4VueRAoCertSqK6wLJY1ygKojgwleFDrWHQqhK+VBucCrKPNzE2BTd+fe94hBKT0Ompkn5W6Vy8A194t05ED1JHTdx0vaaopa0/bigaQsVPssHsPNfEJVH/KqiOeNrlzvqRTvu8i76JAbJzGialmG/j4MeK5Y06Mcl9Lq2CI4OZPTzArhG+Esk3tdS+F+MwvMYOX7oKaobpZSbiMdLAELjHcCSAIshvDcTHnOPDmlBhsGE1EGkQXaQ2yydUmIrUS/l7HnUmcYXG/3FJSxcIrq4Imk7PrAzgonqrJD3jjBZgB/1PSVFjOMIKFOmyyzzR0X/boQemo+UGaR3ChwAq7lLJYjLc9E13Jio5LRAaNf3kzzBLrjSoxDqegw2EWXKc8MuHqyurf4vSCe400W+VtM88UtMTjvpGM47iEd6ewCmevh/xm+1MkmIxc5zsDuad1uQ3jz8cjLv80u9IrIktXYtluCOMMmNAG1LoAs/0UCG9BcTwA== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Feb 2017 06:40:13.6158 (UTC) X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR0301MB0735 Subject: [dpdk-dev] [PATCH v3] eventdev: amend comments for events limit and threshold 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, 14 Feb 2017 06:40:18 -0000 Updated the comments on 'nb_events_limit' of 'struct rte_event_dev_config' and 'new_event_threshold' of 'struct rte_event_port_conf'. Signed-off-by: Nipun Gupta --- Changes for v2: - Fix errors reported by check-git-log.sh Changes for v3: - Updated nb_events_limit comment for closed systems - Fixed grammatical mistake on comment for new_event_threshold lib/librte_eventdev/rte_eventdev.h | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/lib/librte_eventdev/rte_eventdev.h b/lib/librte_eventdev/rte_eventdev.h index c2f9310..b619160 100644 --- a/lib/librte_eventdev/rte_eventdev.h +++ b/lib/librte_eventdev/rte_eventdev.h @@ -404,11 +404,12 @@ struct rte_event_dev_config { * @see RTE_EVENT_DEV_CFG_PER_DEQUEUE_TIMEOUT */ int32_t nb_events_limit; - /**< Applies to *closed system* event dev only. This field indicates a - * limit to ethdev-like devices to limit the number of events injected - * into the system to not overwhelm core-to-core events. - * This value cannot exceed the *max_num_events* which previously - * provided in rte_event_dev_info_get() + /**< In a *closed system* this field is the limit on maximum number of + * events that can be inflight in the eventdev at a given time. The + * limit is required to ensure that the finite space in a closed system + * is not overwhelmed. The value cannot exceed the *max_num_events* + * as provided by rte_event_dev_info_get(). + * This value should be set to -1 for *open system*. */ uint8_t nb_event_queues; /**< Number of event queues to configure on this device. @@ -633,7 +634,8 @@ struct rte_event_port_conf { * can have a lower threshold so as not to overwhelm the device, * while ports used for worker pools can have a higher threshold. * This value cannot exceed the *nb_events_limit* - * which previously supplied to rte_event_dev_configure() + * which was previously supplied to rte_event_dev_configure(). + * This should be set to '-1' for *open system*. */ uint8_t dequeue_depth; /**< Configure number of bulk dequeues for this event port. -- 1.9.1