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 1A39CA052B; Fri, 31 Jul 2020 21:03:55 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id E2B69262E; Fri, 31 Jul 2020 21:03:52 +0200 (CEST) Received: from mail-io1-f66.google.com (mail-io1-f66.google.com [209.85.166.66]) by dpdk.org (Postfix) with ESMTP id 700A411A2 for ; Fri, 31 Jul 2020 21:03:51 +0200 (CEST) Received: by mail-io1-f66.google.com with SMTP id l1so32655173ioh.5 for ; Fri, 31 Jul 2020 12:03:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=8XVXpK5VOSg7RR986Vqp4gnuSl9BcG53QpqlRCQMseQ=; b=An7S7u3TPw8VvgLD4cUQUY5lhWErHTKzpcRzsVMovJ9SBQtWATFCMQELDto78HqAEu ScC3egVfCwcUQCH4bRP8vmL/TkHfAc1IWDdygXeNmYQZ9QkkAobFWMGyZ3XHgtp9y/Ke Q58FmJt9lNPWZwX39QSEepC4S2uD3Q8D5/ktLSHEkmvhbGRW6RE5rnaqZ9iRg+PsJjxO xrOzbRngacYqLgxIOPUEgpimJSgjZJV4/zBPlBp3IqL+pMruFIxnl6ncaf+/PkdsNJDX Olh4f6ycpULmQkh9yvOYnf0sjDFtORVBrTmQwlJtJOvHPzzJAApev1uvgyBetcUu9a/T lF4Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=8XVXpK5VOSg7RR986Vqp4gnuSl9BcG53QpqlRCQMseQ=; b=G5/Y32Tb7NaB25cLlqXAG5YhGj5cxQCQRbHaDXrOj6tGOlUTPUsYebdf6DEQpKVpQf M9Z0GNqObvhU7PYi27aY0q3NIr/SBdtwvgGepekhjuSUX0ic5avy4HseWvQOeJCTxkMh Jra0lyhVVk7SkQUEFDqjBkN5oMGttVoVg0MMZIxK7lDFzrOlWDcJStjH91wW4sAAiNIK ZMzPTw15Lq6/ja5rTySgVXg6FRuuOvQRfFUav4mq8814w/wFb2X7dgb1Du/5AEO5eP7N KkVQa+luNMxntBilSiPBYb8ExJIz6EdAjpPV6qy8lMmmfBHFfyXEoUEYuuRCoZ81p4G/ Ry6Q== X-Gm-Message-State: AOAM530sNTfm6O1+uqGlgFiT82lOvU2uh8kSjLeKIvZJ0xmPqmp9uCAm Ja+0y4DrKuwgbYdoudxVxIJvaiN64Et4gzVaCMU= X-Google-Smtp-Source: ABdhPJx5IepKa09x4QTriV84FzrC6hBPDgFk7Q8IUEobzExwbCYVWTjGvLwxkAruG2Qf+ft44sAD0mE3YAGU0hW5dSM= X-Received: by 2002:a6b:e40b:: with SMTP id u11mr5162441iog.123.1596222230662; Fri, 31 Jul 2020 12:03:50 -0700 (PDT) MIME-Version: 1.0 References: <1593728037-15717-1-git-send-email-timothy.mcdaniel@intel.com> <1596221511-23552-1-git-send-email-timothy.mcdaniel@intel.com> In-Reply-To: <1596221511-23552-1-git-send-email-timothy.mcdaniel@intel.com> From: Jerin Jacob Date: Sat, 1 Aug 2020 00:33:33 +0530 Message-ID: To: "McDaniel, Timothy" Cc: Jerin Jacob , =?UTF-8?Q?Mattias_R=C3=B6nnblom?= , dpdk-dev , Gage Eads , "Van Haaren, Harry" Content-Type: text/plain; charset="UTF-8" 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" On Sat, Aug 1, 2020 at 12:24 AM McDaniel, Timothy wrote: > > From: "McDaniel, Timothy" > > Signed-off-by: McDaniel, Timothy > --- > 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. Remove this section. It is a duplicate of the below section. One deprecation notice is enough. > - > +* 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 >