From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0048.outbound.protection.outlook.com [104.47.37.48]) by dpdk.org (Postfix) with ESMTP id C7B837CB3 for ; Mon, 11 Sep 2017 10:29:27 +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=NB10i3/TZsARZculaTmjTWupi4KMG/FNISm/sk72UMk=; b=cTKN8WotN99sf556n2KiDzmYYN4WngpsFuFVyS6zvw4H6/IB9dnM7NBIAGsVFc0+kt+KebfOpm9HRODEq78DttJ+s0DEElfVGUsX+l2Hn0/irHMEV7mfSdyc2lrpPW84Lx4qn/VZfgiMMv43uQ0Hsi7zp54YR/6YYMdRH9NPsdk= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Jerin.JacobKollanukkaran@cavium.com; Received: from jerin (14.140.2.178) by SN2PR07MB2527.namprd07.prod.outlook.com (10.167.14.155) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.13.10; Mon, 11 Sep 2017 08:29:24 +0000 Date: Mon, 11 Sep 2017 13:59:01 +0530 From: Jerin Jacob To: Tim McDaniel Cc: dev@dpdk.org Message-ID: <20170911082900.GA10234@jerin> References: <1504646088-3476-1-git-send-email-timothy.mcdaniel@intel.com> <1504712527-28878-1-git-send-email-timothy.mcdaniel@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1504712527-28878-1-git-send-email-timothy.mcdaniel@intel.com> User-Agent: Mutt/1.9.0 (2017-09-02) X-Originating-IP: [14.140.2.178] X-ClientProxiedBy: BM1PR01CA0085.INDPRD01.PROD.OUTLOOK.COM (10.174.208.153) To SN2PR07MB2527.namprd07.prod.outlook.com (10.167.14.155) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 44172671-333d-4635-1dfe-08d4f8ef368e X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(300000502095)(300135100095)(22001)(2017030254152)(300000503095)(300135400095)(2017052603199)(201703131423075)(201703031133081)(201702281549075)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:SN2PR07MB2527; X-Microsoft-Exchange-Diagnostics: 1; SN2PR07MB2527; 3:rJOh1WwO1qb/8WwCziUqcmKHxu2jrpfp/Km4HXK7TwHO/0mYKzl075JK9ZF6BBVHoF8lMiPWS3K24Pqs7qmmgCE4ABuIytQA6xPwtaWqtbhApv722k7hQID/HuNUV63785dtK8tkMV5Cy2nKWf5D02ld2ULhC4VxjaxhhkFCChjDPho6ea8a+hYtbyxNkFBLMGNyUc8fkab5shjZJFfUwYN2xQfrZcHyE3bD8OeFpkB+UCzvwRLjNMFTiUTSKWLq; 25:FlabZIttrIiucn2AkmEMG4470OQjdRZor/YmuUs/49gvM99NqONSrP5oqxf5SREMqU4DTlxK366xC3uGTbP1yaySVfari/Q4rNC3SeFg5Y94fZxdaUBRFNNGm48yC+lmDTLzOlLMNT9adoaW/yKC+mJL4NY5LIZW9pGW4Ms4db393cknQgPiGaX5NiFCi8d//NuFJ6X7DIYUUreQB3bWMd9f/kpvjJz2s2OW6QPZJurqHYy55kwdN3QvTnRtPe0mZqkE1IhZGvzaO4xyrg6RU+so6aW5V9sjPZM+Cpfn/I/BAmBeeETHZLGBqnU1thobMDtGd5onWM/u2efIdG+znQ==; 31:lQWEbrWc/bZQKN9GbJlaUzyaXM0GP2piDtYNgYhvVXaV0MAOCj7DFeTsB1XoKht2mgiLSS9kWAY9+v2N/e1Dl3uP3ivSvsVXdCjnkSKzizlya7MVQDJKsxTrxockFJppAAs0NdQBQvJyfX6KDOKeZbAlAdmAbSaWmzWRoLc48QIjtEPaoKD0hPWuN/dUBD4uWqtfCetKyL5kpHzfPLQMeE6ldet+3yrvUkfa7F34VPc= X-MS-TrafficTypeDiagnostic: SN2PR07MB2527: X-Microsoft-Exchange-Diagnostics: 1; SN2PR07MB2527; 20:1UD0THO2FNKF/38SrCot8GPWtegfBC3arUIvMBiD9+Nq8s6No8iEM1oo9GbEq3ie4TtWumd/ZDzgF41mbWAgIPgoaYHmv/L/ryW0cYu65RA3oMqV9KnjjhZw2/F+t2WSJWfavmkFHyWCq6EjCFQ6Rhv0ho3b1oSMKKbTbKu5wpaVAKm6npERJC3q5xYX8B2+Fzx5jdSnzEzcKk2rP1CpmrgeiZfYldgQD6lKn8nkEu7d4vWwolCucl+P0Y1UCTRQWim59GRG1/YtHhTG9RutXKafKr8ufo1g9eTSvQBNa74E0JgYz10/PIBm2zMUf5pYVlk44kIKrzGD8AnWUWN+NTlli+VTnY66+0fD73lldm4OTfiBzXTjBOeOoPiHvmD/dxnMull+116oNj4RUOueFFFjxMAi+dOyojdnFXR7SxrZ0esIZkqNTt9V7NMF0Vv8mFblSbRBXPzM9AODldM0KsTgTGadzTq0AzWOXE90wS9Rmz8LGwYpKT4BwNue31uX02bKhSioclz9qHD7iGcsrIe2I5wBWtXC4AuHOvY5HSj57ePhaxYe6XibeDeomfgdr+tJEApb20gCV8SRj94ncRcVJQVAOReZfapFq50mSqM=; 4:U0u/m3STKC/pEQ0RdkqJqBPzbkDmt0ssvDTk2v6Zd+hwNHSai89X/rx42zfvMhZsFdf1YGfmp92GJUsqdK7C/hG3V7MUjReQOc5n8mDIXxGx4pikZMLmGveDEuvyImW7vrV9XyAdqa1qpq88q9sZ8KB2nwIirzg0++5CRYs9/a6EV9WsAAHCl+hqzstnVK/dj9TxaJjk8j21WC9lz2kn+R2mZ8bRrXvDbsI5UyObJG6xinR6VstlOe65dlb1/unVqyLHGv7YosQaHTtcWY3Kd4jlFFF79uNOtc/ARbur4nE= 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)(10201501046)(100000703101)(100105400095)(3002001)(93006095)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123562025)(20161123558100)(20161123560025)(20161123564025)(20161123555025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:SN2PR07MB2527; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:SN2PR07MB2527; X-Forefront-PRVS: 04270EF89C X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(979002)(6009001)(13464003)(189002)(199003)(72206003)(42882006)(2906002)(229853002)(110136004)(8936002)(6246003)(101416001)(189998001)(2950100002)(55016002)(105586002)(305945005)(6916009)(97736004)(4001350100001)(4326008)(25786009)(7736002)(6496005)(54356999)(50466002)(76176999)(478600001)(81156014)(6116002)(81166006)(53936002)(42186005)(47776003)(23726003)(5009440100003)(1076002)(68736007)(33656002)(50986999)(9686003)(66066001)(33716001)(6666003)(8676002)(53546010)(83506001)(106356001)(5660300001)(3846002)(110426004)(18370500001)(969003)(989001)(999001)(1009001)(1019001); DIR:OUT; SFP:1101; SCL:1; SRVR:SN2PR07MB2527; H:jerin; 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; SN2PR07MB2527; 23:WaqW/qKAIsqADLM9jFieOiV4m+f3RkY6NmFJMDr55?= =?us-ascii?Q?cZDw29kfI+rxGvYZBF9FN8lWD+Ep+ZeXZN091YsRRru9aEBS+WCWApD1urmV?= =?us-ascii?Q?yScmAqtzRgJ3magJLWkOQKkB19molB09QZbuJrCad4soRHmFFmaeqQXpPXAA?= =?us-ascii?Q?5zPWPnptLf8lwNjOmSkmFv6ecoZTBEzZHCLRjMHnHTzv56LKU5GLeT7sqBr/?= =?us-ascii?Q?43+gsyOA5jwU0LYgWQT6on1Pn9v4+hLeM2S81Bk/T2VdyJWICjChTKnE0VYx?= =?us-ascii?Q?xp7D1kkMyyKM7VbqNUHiCmWjEvztZRtTktpwvwgvYhtX78QUbOElMKotSAY7?= =?us-ascii?Q?Y0F9V3PaTvk+cq2iNx4Hic90he8J5O2qiMx2Xnp7d5QOeLqbiFgQptQwMAa9?= =?us-ascii?Q?OQlvxHr4l28M5ufVs9u+J9CRLijQE+lf5CCwvbmtK6jsDHC2XxUvS7LgsKnr?= =?us-ascii?Q?zfYdfinqzUg6u41iN+MPHCFkG3pctzAtTrIulPeP4bbqMVNhHMbXziUFsgXZ?= =?us-ascii?Q?ffrruScVIfNxzbAMpfOTwGGIwZo7VA0mC4vNkYUwfZnOsdS3/UQHfYQkEgEj?= =?us-ascii?Q?6KcsyayRuaCWAtPH+nQXDN21semg6Nz6JWkBk58EplqEXpxemfXZz/4S4Xbo?= =?us-ascii?Q?m83YVU8JMT57RvcGhlaVb/x/LildjyAWqMEaBCd4qZe+Gsblok5f8818jRUo?= =?us-ascii?Q?LT8PbgckENL9ENp+1speyijc501EznD+Va1DdC5VBMjjxDPjUY/6lkN/8mQ7?= =?us-ascii?Q?Om2qLbHEJ1gg1HJa2gsma2bltydo9C6hD3/kTomFmUkLMcbjq6loDhCkm8YK?= =?us-ascii?Q?UqW/C2FV1u8Uxph4SsWVp3hcOa5hPZ/cpnAI1EVnNIC0pYK/mRuZzOTkiU6l?= =?us-ascii?Q?xb1e7hNqV/ydHpuHOmGkW+QDMOO3igw9P7m/i1YkceOskrpqTMIfKaPKAZhq?= =?us-ascii?Q?LCaxY/Cd9bYu31sZakamRddDHDEbMABaJexRstZCtBFwreWFKXMZaBEKIe5q?= =?us-ascii?Q?5a42L7NrSf0JxEnxa/2pNzI6zecsSg/GQSXS6fjkwf1vQZWtkctOeEenpvsR?= =?us-ascii?Q?TOBEMgcoxxGlD6i381kvR/K6vt9IA1f+PdTa9T+uM+YbCp9/BP9ZPGX5C4cR?= =?us-ascii?Q?LIxsDeNEUps+jMU6l7vd33tAzFOFVIv9BsQ9JBkI4ssIFS3vT568LP+4FlFZ?= =?us-ascii?Q?HvNebFA0zu1RkVSqNuWZ45vxwfwwcIOWB7wL1U8gcAQJE6ESfGicV6494czv?= =?us-ascii?Q?e66C1nujuS0a7j8PElYW9VuaBqSkQM4t2wN6eP7DcglutLE4737UnhfvCqng?= =?us-ascii?Q?Aobsfe+WEh9UEHGmkQUbsKgdHcOrsb1a3pOzny/MKgg?= X-Microsoft-Exchange-Diagnostics: 1; SN2PR07MB2527; 6:g6KIB5cZHiAlMogdRt5Mne71JBIpghxBHpIzUhywdikZrWv3v5osJcAO5/uZxZQ10t5z9DHxHfICzZMAMVAm5UP6Z3YPhc8H4WtX0nIZdtMqFd+V6XCudThxjeo3Al7fxVOTwwdwP+BqFc3fuV7HAm1G4CNSBAUEQnEt2NOF5DjAy7mqX7rjTGzRanUBIyDZ8huT5Op6Kby9Shv++JEkudCaqKzTt8+YNzgnGsPgvbvGpMPXCxZ68ovVc5na9qxxRVw5LKvhwZgMW8TsuVPkRJkKBJJUkQf0X8Pq3TwS6FG+6sDQvomekvIF+qEDFL7lMLb9EB7Znit2F6WcirNNDA==; 5:Lq7ttVoc/tBmkPgpAIa8KqHcOaD3rfeEmLy2nxYpWpqozxkLcz04+Td7F1kTjO8YY2m+4cFFhMp1+PnwCul9eIz2TvwPwlfMXj20tYZcbFyv6ZNVmr418TZ5XDgT7HdH+sKVnfE+2bpKHPSPOtYUvA==; 24:qJLo6ItwTntb7WG24PuqB+BGeMIgNIR60aMpEKeV1vnTx6/c53hcMFXehcFXVC397xry74ZTJK8yklQNPqKvCfiCeMy522wKXXFSbSyPowk=; 7:PFXQNRGII074WAuZpqntCEjWFy+kUqmiBPfpcfXydAP46yEpLxAHofRBIdm9OQGTeM5hXqmhQE4uY0C6DsMuD6Fr0gse3ziDBwe2krr0Z/Dzuf1lnvvuFRLyLz0c8+Oc+0zh+lRezo/1UlxGqX9uBHzUVFH4ZqniwI1EUKDkA/hJVB0Thq3TTwAIotDTr/tzA05SnJMIakFWSVjf/5Yf8UXBZ6QxUAAhUel1REV9EOE= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Sep 2017 08:29:24.5050 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN2PR07MB2527 Subject: Re: [dpdk-dev] [PATCH v2] eventdev: clarify usage of forward and release ops 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: Mon, 11 Sep 2017 08:29:28 -0000 -----Original Message----- > Date: Wed, 6 Sep 2017 10:42:07 -0500 > From: Tim McDaniel > To: dev@dpdk.org > Subject: [dpdk-dev] [PATCH v2] eventdev: clarify usage of forward and > release ops > X-Mailer: git-send-email 2.7.4 > > Update doxygen to make it clear that RTE_EVENT_OP_FORWARD and > RTE_EVENT_OP_RELEASE may only be enqueued to the same port that the s/may/must > original event was dequeued from. > > Signed-off-by: Tim McDaniel I could fix the above change on apply. Acked-by: Jerin Jacob > --- > lib/librte_eventdev/rte_eventdev.h | 14 +++++++++++++- > 1 file changed, 13 insertions(+), 1 deletion(-) > > diff --git a/lib/librte_eventdev/rte_eventdev.h b/lib/librte_eventdev/rte_eventdev.h > index 128bc52..cf246a4 100644 > --- a/lib/librte_eventdev/rte_eventdev.h > +++ b/lib/librte_eventdev/rte_eventdev.h > @@ -882,7 +882,10 @@ rte_event_dev_close(uint8_t dev_id); > #define RTE_EVENT_OP_FORWARD 1 > /**< The CPU use this operation to forward the event to different event queue or > * change to new application specific flow or schedule type to enable > - * pipelining > + * pipelining. > + * > + * This operation must only be enqueued to the same port that the > + * event to be forwarded was dequeued from. > */ > #define RTE_EVENT_OP_RELEASE 2 > /**< Release the flow context associated with the schedule type. > @@ -912,6 +915,9 @@ rte_event_dev_close(uint8_t dev_id); > * or no scheduling context is held then this function may be an NOOP, > * depending on the implementation. > * > + * This operation must only be enqueued to the same port that the > + * event to be released was dequeued from. > + * > */ > > /** > @@ -1144,6 +1150,9 @@ __rte_event_enqueue_burst(uint8_t dev_id, uint8_t port_id, > * The *nb_events* parameter is the number of event objects to enqueue which are > * supplied in the *ev* array of *rte_event* structure. > * > + * Event operations RTE_EVENT_OP_FORWARD and RTE_EVENT_OP_RELEASE must only be > + * enqueued to the same port that their associated events were dequeued from. > + * > * The rte_event_enqueue_burst() function returns the number of > * events objects it actually enqueued. A return value equal to *nb_events* > * means that all event objects have been enqueued. > @@ -1346,6 +1355,9 @@ rte_event_dequeue_timeout_ticks(uint8_t dev_id, uint64_t ns, > * with RTE_EVENT_OP_RELEASE operation can be used to release the > * contexts early. > * > + * Event operations RTE_EVENT_OP_FORWARD and RTE_EVENT_OP_RELEASE must only be > + * enqueued to the same port that their associated events were dequeued from. > + * > * @param dev_id > * The identifier of the device. > * @param port_id > -- > 2.6.4 >