From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <dev-bounces@dpdk.org> Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 51984A052B; Fri, 31 Jul 2020 20:54:33 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 079E9262E; Fri, 31 Jul 2020 20:54:32 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id 136382629 for <dev@dpdk.org>; Fri, 31 Jul 2020 20:54:29 +0200 (CEST) IronPort-SDR: +2X94TMF3Vnq8BOGrTHF3YSgsMQUdTDufezNa8h7OezHsBGfw1q82mJdGp0NtprkDzaej3Uez/ TtjYJSEdaiww== X-IronPort-AV: E=McAfee;i="6000,8403,9698"; a="149670562" X-IronPort-AV: E=Sophos;i="5.75,419,1589266800"; d="scan'208";a="149670562" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 31 Jul 2020 11:54:28 -0700 IronPort-SDR: ufoqLAkfEwe8acTz/UHRJ/BUGqb1wBvWhNP/+Grz/jmmEbZfq4/3VdIZsLbSwPe/Qdyo6DnY0c ZvWgbAs4XgMA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.75,419,1589266800"; d="scan'208";a="465700784" Received: from txasoft-yocto.an.intel.com ([10.123.72.192]) by orsmga005.jf.intel.com with ESMTP; 31 Jul 2020 11:54:28 -0700 From: "McDaniel, Timothy" <timothy.mcdaniel@intel.com> To: jerinj@marvell.com Cc: mattias.ronnblom@ericsson.com, dev@dpdk.org, gage.eads@intel.com, harry.van.haaren@intel.com, "McDaniel, Timothy" <timothy.mcdaniel@intel.com> Date: Fri, 31 Jul 2020 13:51:51 -0500 Message-Id: <1596221511-23552-1-git-send-email-timothy.mcdaniel@intel.com> X-Mailer: git-send-email 1.7.10 In-Reply-To: <1593728037-15717-1-git-send-email-timothy.mcdaniel@intel.com> References: <1593728037-15717-1-git-send-email-timothy.mcdaniel@intel.com> Subject: [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 <dev.dpdk.org> List-Unsubscribe: <https://mails.dpdk.org/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://mails.dpdk.org/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <https://mails.dpdk.org/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org Sender: "dev" <dev-bounces@dpdk.org> From: "McDaniel, Timothy" <timothy.mcdaniel@intel.com> Signed-off-by: McDaniel, Timothy <timothy.mcdaniel@intel.com> --- doc/guides/rel_notes/deprecation.rst | 37 +++++++++------------------------- 1 file changed, 10 insertions(+), 27 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index ecb1bc4..4809643 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -149,30 +149,13 @@ Deprecation Notices 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 be a - uint8_t, and represents the maximum number of event ports and queues that - 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. The - 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-linked - 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, this - field is a hint for how many to allocate; otherwise, regular event ports 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. - +* eventdev: ABI change to support DLB PMD and future extensions + The following structures and will be modified to support to DLB PMD and future + extension in the eventdev library. + - ``rte_event_dev_info`` + - ``rte_event_dev_config`` + - ``rte_event_port_conf`` + Patches containing justification, documentation, and proposed modifications + can be found at + - https://patches.dpdk.org/patch/71457/ + - https://patches.dpdk.org/patch/71456/ -- 1.7.10