From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM02-BL2-obe.outbound.protection.outlook.com (mail-bl2nam02on0040.outbound.protection.outlook.com [104.47.38.40]) by dpdk.org (Postfix) with ESMTP id E83871B1B2 for ; Mon, 9 Oct 2017 14:27:39 +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=YNFcOIb78zrq7v4yXRhJHje+RRaip5dzLajbtMjwX7s=; b=Xf+TYDtk64VrT3BfH/QIFEBKGUGqX5tDNLfKmQmIIREh4n+NlMqMEiYoXJCG2366Kfuf0d4XGe86BpG5V86MLxRBUA1kxXNO6EtObT7g01crRIa1xP3ICM3m8ZBydtYfFDn8aaPaKEK8/nwzWfzV8cVcn15CDG8WwS3ji1QHiwo= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Jerin.JacobKollanukkaran@cavium.com; Received: from jerin (171.61.81.39) by CY1PR07MB2522.namprd07.prod.outlook.com (10.167.16.13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.77.7; Mon, 9 Oct 2017 12:27:36 +0000 Date: Mon, 9 Oct 2017 17:57:14 +0530 From: Jerin Jacob To: Nikhil Rao Cc: bruce.richardson@intel.com, dev@dpdk.org Message-ID: <20171009122713.GD654@jerin> References: <1507324201-3517-1-git-send-email-nikhil.rao@intel.com> <1507324201-3517-5-git-send-email-nikhil.rao@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1507324201-3517-5-git-send-email-nikhil.rao@intel.com> User-Agent: Mutt/1.9.1 (2017-09-22) X-Originating-IP: [171.61.81.39] X-ClientProxiedBy: MA1PR0101CA0002.INDPRD01.PROD.OUTLOOK.COM (52.134.136.140) To CY1PR07MB2522.namprd07.prod.outlook.com (10.167.16.13) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 59e008ad-b258-43c7-eb3c-08d50f1120e1 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(2017030254152)(2017052603199)(201703131423075)(201703031133081)(201702281549075); SRVR:CY1PR07MB2522; X-Microsoft-Exchange-Diagnostics: 1; CY1PR07MB2522; 3:/tVHwYlkNa7C8n7pYokPScmEFizCZTwH9mlHfRPPQOLBAKuII1s/idpNAw6qjcDDaN3WO/aoGdUhzyA904xeN4PKV9decPjvxNNboEiT2YMWByjaydc1rm7z1xdDNzJg2HHCQn2mPd5ty63CQ1YDGbI3IO0ZyoApJjpQUOz1/9icI5eDcqwizcjLZAnSNk6lYrSDMxiIYFucsQCTysq0e8ogrrerDHWIj/tF39wabmNP0rWMCjSIY/t5clzxJtaY; 25:VsudjhbHXszxa29jlUy4FfkyMSrMXcJ/s9YQzIldzIg/0llp6bX2cCfBW/fUxKwpIzrgEZXX+iN+awKv3BsKtL01ZeIx75/C8s3XrbScLMju+Go+XXKn8zQ5nUmXJQHNjxQKQs+larCn9kv5l8zb4J8ZlLtNq8ftbEb6JJ9Bw45GeWLk5usr7xtYC4lUmMUZRE07Ve6k0xvBrBF0/GcGdTOSauWkkboU8m58y4cWLYhMSDl/7GRz7rMxxmq1ZLDe4WwaBTJVsWBcZnIpK7qzNrFmo3dTOvym8SqkfDA4u0J+Z3qrFb9JecL/W5NbEo2DRXUbomaeFCpca7iImWgyXw==; 31:YuSBrXkkIx/Rb7ydzUil9si1orVrv83AuYc5G5wp+2TiPOyF+K07Jd8C3YocTsQ8nGJxK0bwnugkUAJ3gVgcoCDQh0fQ3qUWYYffqwVx8IABcS/1R+ZhNqKlfuAGRh25VTC5V9NWcdYyAlt8TpbSXvH2EAI41yhw+mRmosh6bUIrI2mwuleSwXd2ofTQOQCjVmmAidFMVnZ9QkeqOhWXtBI+Z2oHaHy8Ah0mjYoufws= X-MS-TrafficTypeDiagnostic: CY1PR07MB2522: X-Microsoft-Exchange-Diagnostics: 1; CY1PR07MB2522; 20:HjfzHXjYR3NcsL++6fFHF+47SdltEQrOxHL671IOUJvN74zHE/hfSU2LYHQ5BUEfyBFD5bUXo3QV0o1uo4G3O6kZDj3CTAoZ2suaaqG/By5Ag1JeBimiNqmvSIlxHm6xGyGrR/RmI6A9mfcERHMI1svgyhYkmlcUnLzo/RI9ekJk5U+OPCWQIzEFAgfrVpgI4VoQAqboJrY0ckIsyTfBYHQnEoZ2u97qpRIVfI+V+YqdO1SXGN5Hm43X1iAoXMs4gnVGwiXDsXTKkDARUx2wZJiOz2Joswo0QjBkWya3uthpqvTVcpTDLD8c9UeJpmsLJiuF7fygpGIiF3DRf/rsgXSYy6QuDHs6KqYOnC6O/uJqkDBW5J5xoLoNCC6YygTgzfaV5d5CDa907qox39InrQhQvwVznLiIBvA+hLFcKKDfSUJC6j5ubLVTQWzzO0KRmVXltIQPogddTunMGmfvJVw+zQJvtKK9s6SKy+CykaWWsrkrNLT5VYV5iwqtl4dLo4Ab2/8h2XkYrWN/hRwiekSs4Ronrq53ymU2tDRKNsWcWVEvp2xCKvmYWE9IxUQ9gpBkUfcz6fI00incJlrEKum3GkZFVcj4QhH+LDXHOqk=; 4:6+2yKuG/xGiY655LpaLzs1kD4ujGefO0GP6OfSw/Ed/QmhGwNxsa8mzSQ+vg4oNPMTLwe2EiJ40qOb2zOCGlJJURuJiYLPoQ7Ct1yrvEUGD6Y3HyWuJ5GMX0ybKb/mjtJeeRs7mW0xn/qYSBruRiEQKUXlg/7OKyomsHfA3bFVqGVMn3M8GrrjOA9ujVVNfxlXKxQ/ef+Avh37MQMir7l5lux6t89UAYmumuCcrHSTPE/tYs9OnjLcNsX4SGrCwyGfGGEAD9dLMT61p5vxxZhxdgJYIxNraeEoCtecBME1M= 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)(3002001)(93006095)(10201501046)(6041248)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(20161123555025)(20161123560025)(20161123564025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:CY1PR07MB2522; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:CY1PR07MB2522; X-Forefront-PRVS: 045584D28C X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(376002)(346002)(13464003)(199003)(189002)(66066001)(47776003)(1076002)(8936002)(4326008)(229853002)(8676002)(81156014)(81166006)(6666003)(50466002)(72206003)(16526018)(83506001)(6116002)(3846002)(25786009)(2906002)(23726003)(478600001)(316002)(106356001)(105586002)(54356999)(101416001)(76176999)(58126008)(33716001)(189998001)(50986999)(97736004)(33656002)(16586007)(305945005)(7736002)(55016002)(68736007)(9686003)(5660300001)(42882006)(6916009)(53936002)(6496005)(2950100002)(6246003)(18370500001); DIR:OUT; SFP:1101; SCL:1; SRVR:CY1PR07MB2522; H:jerin; 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; CY1PR07MB2522; 23:tzDCigpN1g0shai2QZdHlOKJaITAbOEDHJv/hb0Tn?= =?us-ascii?Q?C+U0hUDzdcykLf3c7RwTkyLYOb8cYs7GkNj2+Vcnj4F72cgu3wpaCAnZDNH2?= =?us-ascii?Q?aIEEqsm65l/EdsR88BoJC0+lp41+eZ6rVMvkTegS2dzOxs9FPur4V3OTmSkv?= =?us-ascii?Q?3ounukygMDOAPsl8nb1PyjnN8o0BJ01rgWEfCT0G02KjUTNggO/vgr/kZaJy?= =?us-ascii?Q?SA6CSzgij7azccjdip1JpQKP68fLZRlEO2uj66ZO14/3wtcTTDzQJg+hH+TQ?= =?us-ascii?Q?OVGwxXEGrwmtF4RpPxQfbPJVNqVQDo//J9D1eEzIYmc6wINc5uWgo9aIx0Iq?= =?us-ascii?Q?3kWlOCShRlz1WRrzQ+R2hzdqKXs0/QfFDmJsyS6Z+N1KCprqQpUgZb839geM?= =?us-ascii?Q?fSGSgBK3xU8keaP5gAd9kbfZ+lc2efhSxDYlPkXS2LCEYvKO20vIxB0nPdMX?= =?us-ascii?Q?vC/8Gfbmk1dis258Dd3sT+DVdR+SG/hMghmAy2IhJHaEaQMSWO2KXv+S5mAI?= =?us-ascii?Q?KPk2ukehaDA79jtbHqM/d3LDAk0PgqRoxyVr1ZVquz4C7C8ebS17e+oU/M5E?= =?us-ascii?Q?SpN4MRyZAGOOLzXOce+siLEbdgkZQ6DE2ovxrEO4AHqH/u83ppKcBpbS6ihg?= =?us-ascii?Q?E2T5IMJ4+2wkcrZRvXly9QPqqqIKHKfJOSu4WPvFLsAaldyJxCQl2hq41xUO?= =?us-ascii?Q?AIBaBTRfIpwgX27L8EZvvurGGUznB5mE5vHufwBiyOk1oj92CQQ+dLlwIEZ/?= =?us-ascii?Q?tR+hW120vMhyLTEBMO+7yuG953Z75SNQypiHVI6I1p6E7JLBLuCV7brTX9L0?= =?us-ascii?Q?dMoEWZ6iULX6GLtKhopqlF/HIRUlvkXAxNb8FIgnKCFCk/aYihy52XlbqXgm?= =?us-ascii?Q?fHZxO1bSNV+vUs4vX3Q5TBmZ+V+MqT4m190Ley1qpjDb7sBAeJT1hC9xfvbF?= =?us-ascii?Q?cdA7kOl1NVXg4wdQzW9ZTFgQ9bxbUWtP6EG2SO9fcqvKaaPv3KRFw8DtJus/?= =?us-ascii?Q?vvBHIM+lg+BdIIDq/I8pwGzEwhpiUqXnXv4cOeM9sp+RQOZhf1dO1nL5eQgR?= =?us-ascii?Q?TJ9f16EvoqsmmWZuwHsd0vJTsu6LDPigSuAFjivGcyTCYFX4LpMCK5WCk+yL?= =?us-ascii?Q?DSlQP9rDSwcUtQZfNLxunvRnooQ5IGGv8GEPprlrebsHTxLUPj245pgK+XzV?= =?us-ascii?Q?h1W2KO7xg1Mu0ZnjQpMXiUihst4TkjRJfJe?= X-Microsoft-Exchange-Diagnostics: 1; CY1PR07MB2522; 6:joHz9+Tf1kchXEbrlYNJCCCiFIa1+oJHl7/b5yPcqi7KUKAR5+CrUAKd8eQT7viZqnKa+p1vTJVXzhUz8kiK5qnJfTXLHe2joK2hm9aV12kPv7SXrqD9PXScPyCTvi8wwR6oYH98RKUlI9xAD+W7SZ2RHrHFcWCbV1mLkM0JhTJBGld20Ylr4VJPjvx639YnEBW+uIzVgoD/lH9rWFaVCWfnAqz8HBfGxn9As9jywSV2ZKjG+z5N6VhMUgz/40UN+kLJCiSkMvijU2MQZZMVQ5JgRaP3t6s2yY3qzuym8T9CjH9qUBhvFif+KOsqKD0Rav4hX5gSRdoZPRvjDWiuZw==; 5:QQBEILwLboe3aQTjZPy2SNt9clPmlF+JQZ6tgjzucuY8pqM6h2N++drAOKynoSwPNUnofyt3yqfY+VsARIJ7vb5UAFjIiAh37elVnu9C+guvo8FrtLeR8DAbjor4somqIPRBWCjg9lZjgS24oMwvw0iR1HkFXlY0x8RlnSVSQuY=; 24:CsrcshWPZEUVJJgaGXaHCEiRn2S/dmJGDL0io93cas4+Nxr8B5YboU7Xr2SBrB95se5mUgq/4iLjDqL9ebEa9LZdaS6PLZEAXo/GAdlx3B0=; 7:lqtAAkz2kop9WoRJzFiVTBAAZZEUolrH3wlHiLffp8dMeSmXTYA7AFqO15gUNdt4soPXwUdNroR/7xTxVFT7MbDcadqVYGggExrr17j8lLWyq/s6Ul4TBX8VZU7XkwVig2jzIqWnu2HwrxH432EHZ5GWhenueg+uLSuGrg8mQKqCtoYrU/oswzeRjFfxxp/+s/bMzurZJGJkGyqrPn20RUQbpUyUAoa8LnHdzO7kAlo= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Oct 2017 12:27:36.7705 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 711e4ccf-2e9b-4bcf-a551-4094005b6194 X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR07MB2522 Subject: Re: [dpdk-dev] [PATCH v5 4/7] eventdev: add eth Rx adapter API header 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, 09 Oct 2017 12:27:40 -0000 -----Original Message----- > Date: Sat, 7 Oct 2017 02:39:58 +0530 > From: Nikhil Rao > To: jerin.jacob@caviumnetworks.com, bruce.richardson@intel.com > CC: dev@dpdk.org > Subject: [PATCH v5 4/7] eventdev: add eth Rx adapter API header > X-Mailer: git-send-email 2.7.4 > > Add common APIs for configuring packet transfer from ethernet Rx > queues to event devices across HW & SW packet transfer mechanisms. > A detailed description of the adapter is contained in the header's > comments. > > Signed-off-by: Nikhil Rao > --- The EXPERIMENTAL functions follows the following comment in doxygen. Add that for new Rx adapter functions * @warning * @b EXPERIMENTAL: this API may change without prior notice reference file: lib/librte_eal/common/include/rte_service.h > +#define RTE_EVENT_ETH_RX_ADAPTER_MAX_INSTANCE 32 > + > +/* struct rte_event_eth_rx_adapter_queue_conf flags definitions */ > +#define RTE_EVENT_ETH_RX_ADAPTER_QUEUE_FLOW_ID_VALID 0x1 > +/**< This flag indicates the flow identifier is valid > + * @see rte_event_eth_rx_adapter_queue_conf::rx_queue_flags > + */ > + > +struct rte_event_eth_rx_adapter_conf { Doxygen comment missing for this structure. > + uint8_t event_port_id; > + /**< Event port identifier, the adapter enqueues mbuf events to this > + * port. > + */ > + uint32_t max_nb_rx; > + /**< The adapter can return early if it has processed at least > + * max_nb_rx mbufs. This isn't treated as a requirement; batching may > + * cause the adapter to process more than max_nb_rx mbufs. > + */ > +}; > + > + > +struct rte_event_eth_rx_adapter_stats { Doxygen comment missing for this structure. > + uint64_t rx_poll_count; > + /**< Receive queue poll count */ > + uint64_t rx_packets; > + /**< Received packet count */ > + uint64_t rx_enq_count; > + /**< Eventdev enqueue count */ > + uint64_t rx_enq_retry; > + /**< Eventdev enqueue retry count */ > + uint64_t rx_enq_start_ts; > + /**< Rx enqueue start timestamp */ > + uint64_t rx_enq_block_cycles; > + /**< Cycles for which the service is blocked by the event device, > + * i.e, the service fails to enqueue to the event device. > + */ > + uint64_t rx_enq_end_ts; > + /**< Latest timestamp at which the service is unblocked > + * by the event device. The start, end timestamps and > + * block cycles can be used to compute the percentage of > + * cycles the service is blocked by the event device. > + */ > +}; > + > + > +#ifdef __cplusplus > +} > +#endif > +#endif /* _RTE_EVENT_ETH_RX_ADAPTER_ */ > diff --git a/MAINTAINERS b/MAINTAINERS > index 8df2a7f2a..53fd50e1f 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -273,6 +273,9 @@ F: lib/librte_eventdev/ > F: drivers/event/skeleton/ > F: test/test/test_eventdev.c > > +Event Ethdev Rx Adapter API - EXPERIMENTAL > +M: Nikhil Rao T: git://dpdk.org/next/dpdk-next-eventdev > +F: lib/librte_eventdev/*eth_rx_adapter* > With above changes: Acked-by: Jerin Jacob