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 BC599A053A; Tue, 4 Aug 2020 10:52:30 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A1B4B1C038; Tue, 4 Aug 2020 10:52:30 +0200 (CEST) Received: from mail-il1-f193.google.com (mail-il1-f193.google.com [209.85.166.193]) by dpdk.org (Postfix) with ESMTP id E318B255 for ; Tue, 4 Aug 2020 10:52:28 +0200 (CEST) Received: by mail-il1-f193.google.com with SMTP id t4so33488095iln.1 for ; Tue, 04 Aug 2020 01:52:28 -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=CSEtVecDC/53HRASRzMmMLX8+iHDbXkyIVdKxqhyak8=; b=cgIwf3bF5GD3W3KBkScze6Af7KgpL0tmqlh+X0vbjRNELgmUVxEGOkYOjsoJ4qiW5S xt+UMiR6rzi8u7kwsckpxhwG6WCzfeLV8g7W8C3yq8eGBWh10UvGkTKsTVZCc48qEJTI TPe8mN3oJHY4B5TYj6TuGO9JemKKB324G6sRjhbM2PB2IeYRByTXLaPi66dqZavzNYSS OX1g0r7fYYLz+1KPb4SxE5iUYR0LpjIviyrEgvzVXP1J0V4Km3L0UfHzyR7sEeVPBk0g V5pPId4c+1eMqx2yKy6iqeYtLrM7S6p4bpnoEBbfGeBDWu0eUsKk+F0AnvIk70YcIJEP eXjA== 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=CSEtVecDC/53HRASRzMmMLX8+iHDbXkyIVdKxqhyak8=; b=ZpDDJj9nKVAcgDgCRE7OdrnWPJsqvLABoREYHeE0pcALWMD7UyXqTWt+EvLsvL85mF VXiJXnGImIc4J+hRYbUTXD0pBmE0em5wjo/NmJmxuVHq492GsjL5bgT+uZZyMBX1n37F jVVOEr0d0QwlreXN+979Wls233URwIfbux75nCz3pX1jzSzgbhovWp1B2vIu3IWnZ51u Me1btiL734yMkGXNnw4nK+nnplOk5HEwTvFQJusNxSfFbc9d2mhuImOTyF+ZqXUj5/i2 /dnqeooS/RGf80PrzSXT/LE1jZ36Tg29GphHUv4q7O6ua/yc7M1q1pl2Kf/eNByjM/99 U63w== X-Gm-Message-State: AOAM530fBalGixGIox6J13QOYd4D6DZP2J7aLA/7Ygw9tUQ4pBDDw6oO b0aV7a+HtJhyabIlfwEuyWN5M8dUMm1sc4hHI60= X-Google-Smtp-Source: ABdhPJwqmN+oHgdUjbdBO800Pw3kyWRZFiKPqnkLbQP013Fk7YjDvGeKDoqJcEb4sqe3Jlc0Ni4u5Q/Vx8OY9LgSQXs= X-Received: by 2002:a92:6a07:: with SMTP id f7mr3774051ilc.271.1596531148201; Tue, 04 Aug 2020 01:52:28 -0700 (PDT) MIME-Version: 1.0 References: <20200804084732.882-1-david.marchand@redhat.com> In-Reply-To: <20200804084732.882-1-david.marchand@redhat.com> From: Jerin Jacob Date: Tue, 4 Aug 2020 14:22:11 +0530 Message-ID: To: David Marchand Cc: dpdk-dev , Thomas Monjalon , Dmitry Kozlyuk , Gaetan Rivet Content-Type: text/plain; charset="UTF-8" Subject: Re: [dpdk-dev] [PATCH] doc: announce PCI resources map API removal 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 Tue, Aug 4, 2020 at 2:18 PM David Marchand wrote: > > The PCI resources map API (pci_map_resource/pci_unmap_resource) was > imposing use of Unix mmap flags while it does not make sense on Windows. > This API was only used to internally setup PCI devices in the PCI bus > driver and has no known external users. > > Announce its removal in 20.11 with its associated structures. > > The workaround implemented in the commit 9d2b24593724 ("pci: keep API > compatibility with mmap values") will be removed at the same time. > > Signed-off-by: David Marchand Acked-by: Jerin Jacob > --- > doc/guides/rel_notes/deprecation.rst | 11 +++++++++++ > 1 file changed, 11 insertions(+) > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index ea4cfa7a48..24808c002c 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -67,6 +67,17 @@ Deprecation Notices > us extending existing enum/define. > One solution can be using a fixed size array instead of ``.*MAX.*`` value. > > +* pci: The PCI resources map API (``pci_map_resource`` and > + ``pci_unmap_resource``) was not abstracting the Unix mmap flags (see the > + workaround for Windows support implemented in the commit > + 9d2b24593724 ("pci: keep API compatibility with mmap values")). > + This API will be removed from the public API in 20.11 and moved to the PCI > + bus driver along with the PCI resources lists and associated structures > + (``pci_map``, ``pci_msix_table``, ``mapped_pci_resource`` and > + ``mapped_pci_res_list``). > + With this removal, there won't be a need for the mentioned workaround which > + will be reverted. > + > * ethdev: Split the ``struct eth_dev_ops`` struct to hide it as much as possible > will be done in 20.11. > Currently the ``struct eth_dev_ops`` struct is accessible by the application > -- > 2.23.0 >