From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 91AACA052B; Thu, 30 Jul 2020 18:33:47 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 0109AE07; Thu, 30 Jul 2020 18:33:45 +0200 (CEST) Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by dpdk.org (Postfix) with ESMTP id 9B6FCA69 for ; Thu, 30 Jul 2020 18:33:43 +0200 (CEST) IronPort-SDR: kzMkG1GPKQ5gDM/cQnxVyYV/WcOM/LU0FZ/dkUoFGe2/yztxrt1pFt3Dx8PlI3dTipQrbpLRC6 lkphjp3hbhFw== X-IronPort-AV: E=McAfee;i="6000,8403,9698"; a="131201399" X-IronPort-AV: E=Sophos;i="5.75,415,1589266800"; d="scan'208";a="131201399" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Jul 2020 09:33:42 -0700 IronPort-SDR: i2vnkC0RxeROnZXLzYuWs4Rh6LWxKlqVGgt6gvSso3aDI6Yg4asFFlTxKkmKhpzHlYauUffT5l CuCCHwinXkdw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.75,415,1589266800"; d="scan'208";a="490716734" Received: from fmsmsx603.amr.corp.intel.com ([10.18.126.83]) by fmsmga006.fm.intel.com with ESMTP; 30 Jul 2020 09:33:42 -0700 Received: from fmsmsx603.amr.corp.intel.com (10.18.126.83) by fmsmsx603.amr.corp.intel.com (10.18.126.83) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1713.5; Thu, 30 Jul 2020 09:33:42 -0700 Received: from FMSEDG002.ED.cps.intel.com (10.1.192.134) by fmsmsx603.amr.corp.intel.com (10.18.126.83) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.1713.5 via Frontend Transport; Thu, 30 Jul 2020 09:33:42 -0700 Received: from NAM11-DM6-obe.outbound.protection.outlook.com (104.47.57.171) by edgegateway.intel.com (192.55.55.69) with Microsoft SMTP Server (TLS) id 14.3.439.0; Thu, 30 Jul 2020 09:33:42 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lGI7WChD5lMfhV6GZ4oNHqVMr12UNyo6dxc/m2eD6QAPBemLAYuxUpUP14PGSPtNAYdZBF+0xzkkJ7X6AGwLWxYnWYhjZttrXY9wHQq+F35IrxoFmGkbFl81l1ujxytCecnwKDfKAJbkGmGRPUMlSzk+sVjkbxzU0Z3W9SiRLe8EWFz3NW8rQLpp9Eia0yOAWEAA/19JRzqc8tAgi/US1K64NWOzxDu/uBJ3jzTUYMABg/8vXReCiOKgZ0w4wf86ACBs7jmTBuUI1q6/lgU7BOYvkf2KbYFZKuzXnvP8A0iE7adljmsC69FYfDj/4GAncr1Fp3dsm0i3ezQEJRb9MA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=gZF6zIoy7ecZ7g9qFs3u9jfy23yH8cXrG6FYL0aT2Tg=; b=KVAmQE0eD7M/CgCv07lrC0Ppg0FD5j7/SmBh8hDCCTnMW8mnTDQOiyNGjIiFneNqFvR82/VRS8y5dyUQVoSGWZDXFEX6Hxt0GwVcl3KalXE0kCMsyo6qfHQNAUuOUh9Qh1VmD97TTjDJpFpNGv6BfOEAtccEb+3tNWqelPOrOes1Tc88wsNVCWPMzCUgP49KiyLTt++3I6pAL8JCZICod1sKvuUR4uaQXzOKNflopCwMl0WL67yeX9O/V3gktj7+apFqV9pM3VhZ5TUx9s25k67bPs26aqynZdqE8u/ETULJzg2X7UKoZYsF4dEaOrInlaH9W3AqaHJyTnOU3sG2Jg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=gZF6zIoy7ecZ7g9qFs3u9jfy23yH8cXrG6FYL0aT2Tg=; b=Mt4UU5o9KJZuLo4h7EU/PWBnBZek4IVTyYOMSOtmDPgKrCbWMttZInrID9XYuymBwF+aGNKsUVApLJaa1Ity90KQLahZUfZ1oJotF2HijNsaOsg+rpQhGPdi+jA5DFea79p2/iz0QTgV9wsFoF9NQUr0SYIPVyB+QWxb/HT1o0I= Received: from SN6PR11MB3103.namprd11.prod.outlook.com (2603:10b6:805:d7::13) by SN6PR11MB3023.namprd11.prod.outlook.com (2603:10b6:805:d3::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3216.26; Thu, 30 Jul 2020 16:33:40 +0000 Received: from SN6PR11MB3103.namprd11.prod.outlook.com ([fe80::315c:b477:373c:11f3]) by SN6PR11MB3103.namprd11.prod.outlook.com ([fe80::315c:b477:373c:11f3%4]) with mapi id 15.20.3239.020; Thu, 30 Jul 2020 16:33:40 +0000 From: "McDaniel, Timothy" To: "dev@dpdk.org" CC: "jerinj@marvell.com" , "Eads, Gage" , "Van Haaren, Harry" , "mdr@ashroe.eu" , "nhorman@tuxdriver.com" , "Rao, Nikhil" , "Carrillo, Erik G" , "Gujjar, Abhinandan S" , "pbhagavatula@marvell.com" , "hemant.agrawal@nxp.com" , "mattias.ronnblom@ericsson.com" , "Mccarthy, Peter" Thread-Topic: [PATCH] doc: announce changes to eventdev public data structures Thread-Index: AQHWUL50b1z/+YC//0yKKUYo/f2SDqkgfFjg Date: Thu, 30 Jul 2020 16:33:40 +0000 Message-ID: References: <1593728037-15717-1-git-send-email-timothy.mcdaniel@intel.com> In-Reply-To: <1593728037-15717-1-git-send-email-timothy.mcdaniel@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-reaction: no-action dlp-version: 11.0.600.7 authentication-results: dpdk.org; dkim=none (message not signed) header.d=none;dpdk.org; dmarc=none action=none header.from=intel.com; x-originating-ip: [162.251.9.49] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 00666209-f9b4-473c-6299-08d834a65153 x-ms-traffictypediagnostic: SN6PR11MB3023: x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8882; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: IVxIQd7M4JGhDWaI0NtFJBo3zaGfmNStD0iGB4NboLqL/F22ETLrHTZHOSeiWU9szM4litQG8Ic3Ij9jqpt8uSYTgcDeiN7eq22G2C5LBoyLY5JcaEdfIuxjMX+Ym+UZEyh0GE0KoBdemBHKcp8OQWTsilrYOG/b1iJFWmM8VNjO1hTeTwfXigYyPqbOMyrUGU7hXPUpVj3I/fvn92qu6Q+FMCvF7djcEzB2eIlz39ogcjn2ql31+BwdVsjYw1xsC/Jzxlnf3b1Vu+GMz1H3WthHystqrmm2hCsmX6sPECqxQLQNycxytLoJ+ZFMH2pHStZGLngNdZjod+rbvmvn9A== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SN6PR11MB3103.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(396003)(136003)(366004)(346002)(39860400002)(376002)(26005)(6916009)(7696005)(2906002)(8676002)(8936002)(6506007)(5660300002)(52536014)(186003)(71200400001)(478600001)(107886003)(9686003)(86362001)(83380400001)(55016002)(4326008)(66446008)(64756008)(66556008)(66476007)(316002)(33656002)(76116006)(66946007)(54906003); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata: FPE3alFwmZCuTRslyZCrw85pbPbrnJIvUbv62NDZpKAjPNAXwrI7kZ9nmOXTj4QO7+vlFepIaBBNtqyG3lkyoL5E4kdCbX+zpaxBYiTYL/1Ref2Jt2/T/trVmsWl8/Mau+rFrlknPM3BR8mtTcyD2l/UwNxk9NxSvsfU+6oEmJ9c86abppUodw8NjV5ARP1QpFt0Tq/mE6Md4/w4k9ZymYRT9Vpp2+68GYaLdN1NwudXhe4n5WNzbUTOgF5yNZXZ5VZ/Y87nMrwP0DDTZXPY+vChGM7fNhi7mdFHUCHgVwXULiT3jihYcRoxptlcM1YHJeMxODTlu44duVWk5MIzv+Owm4a+U7MsJkf5U58lhzbEV036mVC1GB3i0EC7AVVK2Zg4NCLG/VDHByAEwv/pXagsKL403hERHesrEF3myKS2c0eh2YotzE79MC6TgoHtjWtL8yxZhtqg5lX4o9LD1Czjk7/Q7ydezd9q6Fi5Wpw= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SN6PR11MB3103.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 00666209-f9b4-473c-6299-08d834a65153 X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Jul 2020 16:33:40.5140 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: HpreSJCH2cdv7b/HRAG5nOi7QdAxqIRdKCCAP3JgrICHoTdg3NZTJDRY9KJy1/U5ILzCPlANXgdFYUxqr3+CpAi1eVNOP/2H5x3MJXxnK+8= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR11MB3023 X-OriginatorOrg: intel.com Subject: Re: [dpdk-dev] [PATCH] doc: announce changes to eventdev public data structures 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" >-----Original Message----- >From: McDaniel, Timothy >Sent: Thursday, July 2, 2020 5:14 PM >To: dev@dpdk.org >Cc: jerinj@marvell.com; Eads, Gage ; Van Haaren, Harr= y >; mdr@ashroe.eu; nhorman@tuxdriver.com; Rao, >Nikhil ; Carrillo, Erik G ; Gujjar, >Abhinandan S ; pbhagavatula@marvell.com; >hemant.agrawal@nxp.com; mattias.ronnblom@ericsson.com; Mccarthy, Peter >; McDaniel, Timothy > >Subject: [PATCH] doc: announce changes to eventdev public data structures > >From: "McDaniel, Timothy" > >Signed-off-by: McDaniel, Timothy >--- > doc/guides/rel_notes/deprecation.rst | 28 ++++++++++++++++++++++++++++ > 1 file changed, 28 insertions(+) > >diff --git a/doc/guides/rel_notes/deprecation.rst >b/doc/guides/rel_notes/deprecation.rst >index d1034f6..6af9b40 100644 >--- a/doc/guides/rel_notes/deprecation.rst >+++ b/doc/guides/rel_notes/deprecation.rst >@@ -130,3 +130,31 @@ Deprecation Notices > Python 2 support will be completely removed in 20.11. > In 20.08, explicit deprecation warnings will be displayed when running > scripts with Python 2. >+ >+* eventdev: Three public data structures will be updated in 20.11; >+ ``rte_event_dev_info``, ``rte_event_dev_config``, and >+ ``rte_event_port_conf``. >+ Two new members will be added to the ``rte_event_dev_info`` struct. >+ The first, max_event_port_links, will be a uint8_t, and represents the >+ maximum number of queues that can be linked to a single event port by >+ this device. The second, max_single_link_event_port_queue_pairs, will b= e a >+ uint8_t, and represents the maximum number of event ports and queues th= at >+ are optimized for (and only capable of) single-link configurations >+ supported by this device. These ports and queues are not accounted for = in >+ max_event_ports or max_event_queues. >+ One new member will be added to the ``rte_event_dev_config`` struct. Th= e >+ nb_single_link_event_port_queues member will be a uint8_t, and will >+ represent the number of event ports and queues that will be singly-link= ed >+ to each other. These are a subset of the overall event ports and queues= . >+ This value cannot exceed nb_event_ports or nb_event_queues. If the >+ device has ports and queues that are optimized for single-link usage, t= his >+ field is a hint for how many to allocate; otherwise, regular event port= s and >+ queues can be used. >+ Finally, the ``rte_event_port_conf`` struct will be >+ modified as follows. The uint8_t implicit_release_disabled field >+ will be replaced by a uint32_t event_port_cfg field. The new field will >+ initially have two bits assigned. RTE_EVENT_PORT_CFG_DISABLE_IMPL_REL >+ will have the same meaning as implicit_release_disabled. The second bit= , >+ RTE_EVENT_PORT_CFG_SINGLE_LINK will be set if the event port links only >+ to a single event queue. >+ >-- >1.7.10 Hello Jerin and DPDK community. Please review and approve the eventdev int= erface changes announced in this notice. Thanks, Tim