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 99EF0A2EDB for ; Tue, 1 Oct 2019 17:20:14 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 61B831B948; Tue, 1 Oct 2019 17:20:14 +0200 (CEST) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) by dpdk.org (Postfix) with ESMTP id 7B1A1CFA6 for ; Tue, 1 Oct 2019 17:20:13 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1569943212; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:openpgp:openpgp:autocrypt:autocrypt; bh=G461SlW0dkbt9fiYDwU8RMiaAkuAndkknsesGXVKDO0=; b=OkUDsSh2o7dzhY/lg5MDUIAT1VS5dXeyA/SnwIuepZsRNqNtepA9tSuFW7q6UsdWXZ4r6h Gxsyg8MQkm5mrS/IO3ndUwgYnioCl6Ro8gVgur5Fd8uWbbA6R2ncHEOfFt/+Q4wK/yEbsJ DPgitXeAPzGf/1YXKTot3zrU1RjroY8= Received: from mail-wr1-f72.google.com (mail-wr1-f72.google.com [209.85.221.72]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-238-Yt9kMo-WNYmkvrcfmpy4kA-1; Tue, 01 Oct 2019 11:20:09 -0400 Received: by mail-wr1-f72.google.com with SMTP id i10so6148458wrb.20 for ; Tue, 01 Oct 2019 08:20:08 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:cc:references:from:openpgp:autocrypt:subject :message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=HqFd8vPTw5hA0rYMoaZmUoJiLlgrqHG0aWISdI9h+q0=; b=YoVXWQhe2sgYM8XPq5hXRGm3iwvP93PTR0IcbCtuacD0kPo33USu3avRVEohQ+gZM8 P4Xm66l6qoaUfZs79BfENQWsska39zLUPUXMUozZGVf3Ub4XT4WnCP0hUYVL9G5cLBhk 7A7HbKWwo2YCSA5I2NN/SXuaDabI6jFEtyE6tXlEIUOec/BWC2OAomr7UkbZgH/He75x DIsPR69yIgcpJmx2cg8/8SsZZqZjgAvXOTRVmIana/7AYfpIakYXeweXxca5PbqpdXTj 809nbHaD4KGuhIhb67t3x6otm40JfGQ3/Rn0YK9mLbowILc4X+ozcEW0Ou1AdyxuxuHo djqw== X-Gm-Message-State: APjAAAVrYjrynlAXqZoA+sixyaJprGeU9MFxsaZ0u9C2VFh8V3mPDSS2 cnOt1dC+aCDGk8Jpn3KHqMVMtHiJCwPyDpHET/BdcVltkAtsT5Zw7hlj6S4qmKi7KMBorrtoy7s QmTA= X-Received: by 2002:a7b:cb91:: with SMTP id m17mr4227367wmi.151.1569943207382; Tue, 01 Oct 2019 08:20:07 -0700 (PDT) X-Google-Smtp-Source: APXvYqxzC6bReHzjc4I7502SPxH+kCyqCpIf8zQo0WIah4U3jQJJdphe1LyMwJx3xOHSaMx8NopHUg== X-Received: by 2002:a7b:cb91:: with SMTP id m17mr4227352wmi.151.1569943207098; Tue, 01 Oct 2019 08:20:07 -0700 (PDT) Received: from dmarchan.remote.csb (lfbn-1-8944-244.w193-250.abo.wanadoo.fr. [193.250.84.244]) by smtp.gmail.com with ESMTPSA id l18sm15567523wrc.18.2019.10.01.08.20.05 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 01 Oct 2019 08:20:06 -0700 (PDT) To: Shahaf Shuler , anatoly.burakov@intel.com, yskoh@mellanox.com, thomas@monjalon.net, ferruh.yigit@intel.com, nhorman@tuxdriver.com, gaetan.rivet@6wind.com Cc: dev@dpdk.org References: From: David Marchand Openpgp: preference=signencrypt Autocrypt: addr=david.marchand@redhat.com; prefer-encrypt=mutual; keydata= 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 jnmGuw== Message-ID: <59222af3-d9f1-6f92-f313-1f04402efd86@redhat.com> Date: Tue, 1 Oct 2019 17:20:05 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.8.0 MIME-Version: 1.0 In-Reply-To: Content-Language: en-US X-MC-Unique: Yt9kMo-WNYmkvrcfmpy4kA-1 X-Mimecast-Spam-Score: 0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Subject: Re: [dpdk-dev] [PATCH v4 6/6] doc: deprecation notice for VFIO DMA map APIs 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" Hello Shahaf, On 10/03/2019 09:28, Shahaf Shuler wrote: > As those should be replaced by rte_dev_dma_map and rte_dev_dma_unmap > APIs. >=20 > Signed-off-by: Shahaf Shuler > --- > doc/guides/prog_guide/env_abstraction_layer.rst | 2 +- > doc/guides/rel_notes/deprecation.rst | 4 ++++ > 2 files changed, 5 insertions(+), 1 deletion(-) >=20 > diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides= /prog_guide/env_abstraction_layer.rst > index 929d76dba7..ec2fe65523 100644 > --- a/doc/guides/prog_guide/env_abstraction_layer.rst > +++ b/doc/guides/prog_guide/env_abstraction_layer.rst > @@ -282,7 +282,7 @@ The expected workflow is as follows: > - If IOVA table is not specified, IOVA addresses will be assumed to = be > unavailable > - Other processes must attach to the memory area before they can use= it > -* Perform DMA mapping with ``rte_vfio_dma_map`` if needed > +* Perform DMA mapping with ``rte_dev_dma_map`` if needed > * Use the memory area in your application > * If memory area is no longer needed, it can be unregistered > - If the area was mapped for DMA, unmapping must be performed before > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/= deprecation.rst > index 1b4fcb7e64..48ec4fee88 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -35,6 +35,10 @@ Deprecation Notices > =20 > + ``rte_eal_devargs_type_count`` > =20 > +* vfio: removal of ``rte_vfio_dma_map`` and ``rte_vfio_dma_unmap`` APIs = which > + have been replaced with ``rte_dev_dma_map`` and ``rte_dev_dma_unmap`` > + functions. The due date for the removal targets DPDK 20.02. > + > * pci: Several exposed functions are misnamed. > The following functions are deprecated starting from v17.11 and are re= placed: > =20 >=20 With the ABI freeze that is going to happen in 19.11, this can't happen in 20.02. What would work best from your pov? I can't see any in-tree user of rte_vfio_dma_*map, do you know of users of this api? Thanks. --=20 David Marchand