From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0060.outbound.protection.outlook.com [104.47.42.60]) by dpdk.org (Postfix) with ESMTP id 62EE1324E for ; Wed, 17 May 2017 20:09:37 +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=gfWiw0iOdvJM8hBVSizA37Tk3O5HOogY99KMS33KjB0=; b=cQeJ8KKwfP1qACcPrzbATclFvw/dGh2uFbXPR8fV3editwajNVDmugMi/k5rS/KoDFf6aFqy40WK1e+gGrxf9G6G0L0siX76BU5d6OaHc2cGSiCsKoc/21GvccDkBD1CeyFwUFH4UY4j7+EdyB5BIBGSHcmkHgI7eJPhwhoZ/c4= 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 CY1PR0701MB1725.namprd07.prod.outlook.com (10.163.21.14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1101.14; Wed, 17 May 2017 18:09:33 +0000 Date: Wed, 17 May 2017 23:39:13 +0530 From: Jerin Jacob To: Gage Eads Cc: dev@dpdk.org Message-ID: <20170517180911.GA9503@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: BMXPR01CA0034.INDPRD01.PROD.OUTLOOK.COM (10.174.214.20) To CY1PR0701MB1725.namprd07.prod.outlook.com (10.163.21.14) X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY1PR0701MB1725: X-MS-Office365-Filtering-Correlation-Id: 0c87a39c-c387-4628-3ab4-08d49d4fdff7 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:CY1PR0701MB1725; X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 3:YOkI9O7PA5kz18ek+spf10sl9C1OsvY8sE2TgCqG14adO6GnxvjyBuqp2pFv5ILW4F3962HIrp/g5ITt19BQvl+Q1HiIBp/Khz0xJrs5v1mIyApAgZfDtEUbivjhLGKy5kQPMAkJ8W0TEIBqXVQf5rVjPXHYTSoBykzknw0xVlD+vPoY4XaYV9fzhRuJrrcC2sQ+tgcF+M/AH9ad6mS0LAPpTQC9gMU6LnBcbdswsDgQEn0KfPfV35+5q3lg+AKeRmO6M7H+Ip6BLyoVIaQ4rpjBHoW9PU+cnysAtphRN65AkRzenX+w6RAMeX91B/EnSlWJxZB/46KKcvfK0vC6oA==; 25:CXdAZhNe8LnTwXdjOAXx7I4g6jQ1sE0C2VJr8kdqk750kjyAOr7anNLwoxvISnog8tlT1Pt3zdvLUGpdWpPWhD8P5WCE2mFWBWw2M/m25yKW5QW5VQMA0pAqHXf+xB6LFGHhQTXZZWxYnyQLn36ZAcE+6PsnIGtXi6FoUQkJYmYwZ7fiHlztQldoxKhRpgFQDu3wQ1SrEkO/2umMTEusYlRF9mp4yV+3Sn4o7c9mUrq/FB6BY+DLGKdBUKFHLI7fLUmU7mc4kicDJCNtiBParzzBHZaDvReejHjTg9trrVXv1uh+WWRbPZx0gwIOsu3QolGzA46v+tjtTndoqeDvsgeZKCBa/JWSPTCWMwON4QektDGQn3NnAmTXDRGXgMMUKks/0arDNkXpVE/IZM+pzHIJJHwHFRmgO1QRvwUWwTTlZLzYTcdzUYOAPiaJhke4zVOB1/eShaB8atczCglMYW54CyqDftbV9RRUz+BsJ7k= X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 31:TasEhgRgq/kM0j3ZhdQMogsWNzYIwAU7zGgZ9RMh9U6I+ZgC3Sis1RjsKWT4UmbqGD2ZzOS4gExcMtQ/ckqgEl63L49cErfi7LVQjlpPQSmt+AXqzNNoUG+hcKA5ietNZNAJgcwkRwZXCOz2Gx2Am53XxcOG23FTn8H/qAGIWhlKX6NV6egkxL0QQX+tgJ7Uu7wb2zyjR9fWS5Z3zUlchgB6aOH+mfxm948JC9LAlI+4AyWXmATuFR1gh1nH7IjYsL6RWRdyZ1sGDvxBTx6NEw==; 20:z/tfoFRQUPS2zwGKsngdvN1Sk3pJ9T/j80XnlAfybO4SHMJQj4eN72mW81LMK1pTpdvJ830LBqrRQXjK2aCGsnjmi+SBDC62vqdYvMaOwIYPzF3BrLu20UTk3ynoqrnE2Ld3xjOg7KnFQliGcNnQG/trztgVB879hv2Tdj9NXi2teN5upXcmNb7hNH342JdgVx7XiB7L7rw88hHzVtbgLwbhnDZAkSui/8aFeo8ukfpY/QwD8pknp/hj2a4aJ8AuKLCK6jqq94W7Tj45YB7hzyrZsVlp4f61uJfvC74oQvMrsGrBBwTHop8IslrHzv35jmqbT/GsRA76SGpszrU7TUg/rjZdoZuGzdQh/ZLyQ/kCWwhpJgGOnLgh6oGzEHYJv6/cD/kpfaI1vOmW3sXfuqlCD5bD8FfQIOMRP7C8Bv/lblZdjZ6mx84O34exnP4mNeoEz0FFoZ2O1/BimenWOPmW9IV0vzmDchFctqLGsbxS8FrQ7w6dFteKa9z6kOaDuF2zNo6/SIghOHZU/HO/XwMCBCbkc9Fiu7uA1zY3VUkUdJ1ZjsL64XmJNLv4fq1ScAcg4uRAlc7RHNnPJf6nN3WHQNYmWBJ6klvleX/p0UE= 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)(20161123558100)(20161123562025)(20161123560025)(20161123555025)(20161123564025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(6072148); SRVR:CY1PR0701MB1725; BCL:0; PCL:0; RULEID:; SRVR:CY1PR0701MB1725; X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 4:VC+bSGV/9C6yaKoXbh8xnFGk4PAtllGz4bC9hoGxVH2MO6wPmaacmSBPGmxqft3peXccIGmmMUh84Zar4/xsAO8/rBQuX+pI67Salh7rhh5wTSlvFBQFu5pVLRuDpoIFRhW+04dcm7uk1dpZM+v8RcVkUnHh4EbY5VtMMAH0+yPXAFt34uHTKhPJahonixaNZcfAe0EbH98Wnl/8AazVLvXsAnroTAxa8IRHZwe7h0kfELB2NeWZQlLkj6wgyG63BnhQqGoEou4nh+cludEXS8+Dw83c6g1nb+VS+QwhXdp6F4bBHF6va/cxMsKx/0gly8UAlDWVaLYA7KtMGcXQ/IwxgW8XjH0mNcDlZdxFJfXE2syTZEmy/kh+6CxP7sxqizaDjTAz/53hm+MOqpdFLDN54yiDPhcOOdHxtYnulICBd9pafDx1wFv1NG8JyJyH9O9hyKBgFzVgjFgJFuzkz0XMyzPrS15StiGegSuZckPa6AYVAHVItMzquNcIIuxxxwrtCSO0GCuW06AB8Sy2cNucpSKc3joCPFhV7kiora8SiV0qzPZhjsRj9F73yupGSwAl1efWg7sevh8bKwpFSlE6BZguRLCmNRHVJtI7zM340ADHoLTokTFWeA3x6ebQHfqG/r1s/RG9BlUuXZ6RwWb+3BX5wXWEbwUKyfL/B8cBRNYIUjtAiwPx7BVuALr3F7Qf7MTJYjYyoofptH0n4m5j9e8ZqkfU+uUj5IRxMSntwxIWOB+q07RAPjIPeurnImbs2S6h5XCnBZ2163N3ksSl6bngImQHVj/QN/x5/hNiV+h/4AutdVgFa3yKGA5b X-Forefront-PRVS: 0310C78181 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39840400002)(39410400002)(39400400002)(39850400002)(39450400003)(13464003)(6496005)(6116002)(1076002)(3846002)(23726003)(54356999)(50986999)(76176999)(83506001)(50466002)(33716001)(229853002)(38730400002)(5009440100003)(110136004)(9686003)(33656002)(2906002)(66066001)(4001350100001)(47776003)(55016002)(478600001)(72206003)(81166006)(8676002)(7736002)(189998001)(305945005)(42186005)(4326008)(42882006)(25786009)(5660300001)(2950100002)(6916009)(6666003)(53936002)(18370500001); DIR:OUT; SFP:1101; SCL:1; SRVR:CY1PR0701MB1725; H:jerin; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY1PR0701MB1725; 23:Sbg8PVvxkzo+tsxrzEg0yXT8bSOvA+6m6vUrUq3?= =?us-ascii?Q?G+s8Sv0WxQnv25H4Ull5NOiW+/OEFIoUxUfQVVYfNNcpXkDlVKMPbuQ77umh?= =?us-ascii?Q?5bd94WVu2dG6JwComS5WJuCQuygdqOR68pMeTdr8M+my53YRlJ565AziWUeo?= =?us-ascii?Q?VNjx6IEaOEA+gQhgrvGkrSoB7yq8qSeY7ARmkwMAR1AfXrn5Nh8Zc7XKAXnz?= =?us-ascii?Q?D1vswyp6RPPo+nLIK7G3TPSr/u4YbsstntKkKkhWeIBPRsb0hzHQ4hboIOix?= =?us-ascii?Q?A2ZVAU0vWk9NuUOX1Unw2yYe3LMBj2XthmFO6oahaD4D4dl00JbC8DrlLeY7?= =?us-ascii?Q?EN9oKhulwhJOZVYqPOGP5LjqQSEcQp7l4Op+TTQpfpW8+czOANxUhkpYoNrH?= =?us-ascii?Q?AuIn64WVOQ3puCvmRt8DTEui4mmyBpc0wy1gkgWr3VSDR8j/+26zCi9A1cyn?= =?us-ascii?Q?BO4Dq/Dv2pyCdZsDCbCuep+AhKrxsL/L5r9NffXqdrRq7OJcUVq9h2erYil3?= =?us-ascii?Q?ztoi/MUgWPUREVrQ6TZH4lTgIxFf8olVpWqSgWgTEXkH29VXAGlhtK3LirnX?= =?us-ascii?Q?4tjEKLaeqDcSyxZ+9nQ9ZZ0mwpi2xqIrxS8y1pRBPHsOn20Mz4av0A3fYPCn?= =?us-ascii?Q?hv/qxoRdCfumtjsInbuFsdnVCqcfspU0Uu81zjkQKKLir1UbzAIm24cplrNn?= =?us-ascii?Q?yrM76+5SYRYtXOY7MzM/g4NMsfTw6hoXxpks1j1LXQq32UMhVTXEA8UcSzSp?= =?us-ascii?Q?qjyyQA0J7EF0OdI/UX3he9e2FpL1VJgGoornQtE6BhFb5e2hRv7WCbOP1pL0?= =?us-ascii?Q?l+kznwa0ImO2daafJeTZQy29SJ7c4AUGu5ezLlUyp551OAa69FRGA8cA6bCK?= =?us-ascii?Q?L6YGLtp7Vh8XR4rSHWih3ezkT8QlpToewtT8D7QkYlkTPv6cm14DocqqjKKw?= =?us-ascii?Q?Kw/frM1wMeQZI0Ff4uV2RSIZpW3AEi8Ot2uNgDHjA/z7dRM0p+iqBqNhImmY?= =?us-ascii?Q?l4MtJhk0UHsROw7NQrGS+ro+F/6HB2e2RcpfGzAz/MibfGYF3zZWTtz8ZOkK?= =?us-ascii?Q?3TqF0r8XfkNqJ5WFaCuGxHlqyEFzrxoYztQdfKv4mIdCL4NcatxXjcQTbJys?= =?us-ascii?Q?dUxIxRwp3RQV66/V42LPR+a3cyoJd1E2mutLN//SMFlD9QI+EONG0WXcSveQ?= =?us-ascii?Q?2grIbutVecdSwUFg=3D?= X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 6:gGkGwDU8hmn6WslZzYt8HrZ8RFe8p6Ba9oCi6uWLKLWgTVK0OZ4q4q8mKUzv+XbNykC9nL3dwkEEahfGuIjA2GKwroYBBlAeQCURJzb0nczLvERfksHcYQZMSvUCSrjKmNSMTefoWBdNNfMfojtdqiJopXmEQrKCuow5p1gMpi5VzOG7iexvuASeNP0bP6y6KAqZ5kBanHwre0Rsbvztk1Ca+02ccDNGc1qpha4zNzVnyUEVOBc7bR4vrEIkMVteFGnH/ZOMHddY7GDJOkMwLtK9bG981eox2eksCJrmjHM4NMcgMdr5sFFUqLokHgp9m8D48hOI/QkWYK+MBakjZCzEMhQ6jM67orszoxp4itjyG9W33ebMtpQAjQM+2HQonOlI8/v8tObQWvkSPHT4y+3XGnO9jMpws+kk+EHtC9hyJ9ZGpdiEiuwTQ50dVuwMdq/TrjrnfXbA5zo65SbJ8k6ejZRmHUN/mDPdqLHkSb54VjLDDX9NK7ryDet4vG8spxTCmGnBe9fc6vQxyyJJpQ==; 5:QKOiSDy5xr/a6a/i0tN/Z0FoH0nWttFiMHyKXyh8pNwpnoCVA78EBunK2zhjx2UZrFXleXYSS7vpdNao7hH/KsZdRRBiGshqFdEJqBbu1Z5ZeOcVyv0VaAamxHAfY/K6kKrXKJKaV27fznoJDd8RIA==; 24:qSwFmD3s0LEFjtNb7m7790W4ULPnJK4eHfMZTrwGOvPrdB9azsSK5TkJHWT/MvcUttrTSk5NMFAtS+EHyEcuRx/6tNS0oYqxXlnGHP6tTGk= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY1PR0701MB1725; 7:3/teehKJNzYVYNNnRlh4lXe+E5ltuTnM4lYSu4X9FiOYaoIjCavnZX55ZtWuQqmDS/fcPJQh80Ar3CT9sGKjs0wIvd2Vs1Z5mRwBqguBR3DGlCWBf+ts6N0IId2asPXm+b4UOpZ+bjGb3G34WLlVe8UqGrMrLZyVLHmMJtp+1fa82bml2gpNnHoICbPLG80uNDWcV3yzmEAexktzQXUQfwBX2suUIR3EgvJD0TxmWJXTQOHujFGAZi57hw/xIRFZL3o6+v+gPdRBtkYgW3vQPThv6yelfZReC0rmSUNFoU7Aqz2Y763v+wQQ5pQgbMka+22JWmr1gW3Uh9yXgNoiYQ== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 May 2017 18:09:33.4392 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR0701MB1725 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: Wed, 17 May 2017 18:09:38 -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 Applied to dpdk-next-eventdev/master. Thanks. > --- > 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 >