Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/50415/?format=api
{ "id": 50415, "url": "https://patches.dpdk.org/api/patches/50415/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/33fcd6e0333f51e6fddb3351495c0ef4931b0c68.1550760032.git.shahafs@mellanox.com/", "project": { "id": 1, "url": "https://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<33fcd6e0333f51e6fddb3351495c0ef4931b0c68.1550760032.git.shahafs@mellanox.com>", "list_archive_url": "https://inbox.dpdk.org/dev/33fcd6e0333f51e6fddb3351495c0ef4931b0c68.1550760032.git.shahafs@mellanox.com", "date": "2019-02-21T14:50:49", "name": "[v2,6/6] doc: deprecate VFIO DMA map APIs", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "a54fddccded95dc77c911bc8c54e5af99ffbf7f6", "submitter": { "id": 634, "url": "https://patches.dpdk.org/api/people/634/?format=api", "name": "Shahaf Shuler", "email": "shahafs@mellanox.com" }, "delegate": null, "mbox": "https://patches.dpdk.org/project/dpdk/patch/33fcd6e0333f51e6fddb3351495c0ef4931b0c68.1550760032.git.shahafs@mellanox.com/mbox/", "series": [ { "id": 3501, "url": "https://patches.dpdk.org/api/series/3501/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=3501", "date": "2019-02-21T14:50:46", "name": "introduce DMA memory mapping for external memory", "version": 2, "mbox": "https://patches.dpdk.org/series/3501/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/50415/comments/", "check": "fail", "checks": "https://patches.dpdk.org/api/patches/50415/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@dpdk.org", "Delivered-To": "patchwork@dpdk.org", "Received": [ "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id BEA302BE5;\n\tThu, 21 Feb 2019 15:51:09 +0100 (CET)", "from mellanox.co.il (mail-il-dmz.mellanox.com [193.47.165.129])\n\tby dpdk.org (Postfix) with ESMTP id 7A4A52BAF\n\tfor <dev@dpdk.org>; Thu, 21 Feb 2019 15:51:06 +0100 (CET)", "from Internal Mail-Server by MTLPINE1 (envelope-from\n\tshahafs@mellanox.com)\n\twith ESMTPS (AES256-SHA encrypted); 21 Feb 2019 16:51:02 +0200", "from unicorn01.mtl.labs.mlnx. (unicorn01.mtl.labs.mlnx\n\t[10.7.12.62])\n\tby labmailer.mlnx (8.13.8/8.13.8) with ESMTP id x1LEp2lt022817;\n\tThu, 21 Feb 2019 16:51:02 +0200" ], "From": "Shahaf Shuler <shahafs@mellanox.com>", "To": "anatoly.burakov@intel.com, yskoh@mellanox.com, thomas@monjalon.net,\n\tferruh.yigit@intel.com, nhorman@tuxdriver.com, gaetan.rivet@6wind.com", "Cc": "dev@dpdk.org", "Date": "Thu, 21 Feb 2019 16:50:49 +0200", "Message-Id": "<33fcd6e0333f51e6fddb3351495c0ef4931b0c68.1550760032.git.shahafs@mellanox.com>", "X-Mailer": "git-send-email 2.12.0", "In-Reply-To": [ "<cover.1550760026.git.shahafs@mellanox.com>", "<cover.1550760026.git.shahafs@mellanox.com>" ], "References": [ "<cover.1550760026.git.shahafs@mellanox.com>", "<cover.1550048187.git.shahafs@mellanox.com>\n\t<cover.1550760026.git.shahafs@mellanox.com>" ], "Subject": "[dpdk-dev] [PATCH v2 6/6] doc: deprecate VFIO DMA map APIs", "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>,\n\t<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>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "As those have been replaced by rte_bus_dma_map and rte_pci_dma_unmap\nAPIs.\n\nSigned-off-by: Shahaf Shuler <shahafs@mellanox.com>\n---\n doc/guides/prog_guide/env_abstraction_layer.rst | 2 +-\n doc/guides/rel_notes/deprecation.rst | 4 ++++\n lib/librte_eal/common/include/rte_vfio.h | 6 ++++--\n 3 files changed, 9 insertions(+), 3 deletions(-)", "diff": "diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/prog_guide/env_abstraction_layer.rst\nindex 929d76dba7..6a1ddf8b4a 100644\n--- a/doc/guides/prog_guide/env_abstraction_layer.rst\n+++ b/doc/guides/prog_guide/env_abstraction_layer.rst\n@@ -282,7 +282,7 @@ The expected workflow is as follows:\n - If IOVA table is not specified, IOVA addresses will be assumed to be\n unavailable\n - Other processes must attach to the memory area before they can use it\n-* Perform DMA mapping with ``rte_vfio_dma_map`` if needed\n+* Perform DMA mapping with ``rte_bus_dma_map`` if needed\n * Use the memory area in your application\n * If memory area is no longer needed, it can be unregistered\n - If the area was mapped for DMA, unmapping must be performed before\ndiff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst\nindex 1b4fcb7e64..f7ae0d56fb 100644\n--- a/doc/guides/rel_notes/deprecation.rst\n+++ b/doc/guides/rel_notes/deprecation.rst\n@@ -35,6 +35,10 @@ Deprecation Notices\n \n + ``rte_eal_devargs_type_count``\n \n+* vfio: removal of ``rte_vfio_dma_map`` and ``rte_vfio_dma_unmap`` APIs which\n+ have been replaced with ``rte_bus_dma_map`` and ``rte_bus_dma_unmap``\n+ functions. The due date for the removal targets DPDK 19.08.\n+\n * pci: Several exposed functions are misnamed.\n The following functions are deprecated starting from v17.11 and are replaced:\n \ndiff --git a/lib/librte_eal/common/include/rte_vfio.h b/lib/librte_eal/common/include/rte_vfio.h\nindex 54a0df5726..df139edea2 100644\n--- a/lib/librte_eal/common/include/rte_vfio.h\n+++ b/lib/librte_eal/common/include/rte_vfio.h\n@@ -190,6 +190,7 @@ int\n rte_vfio_clear_group(int vfio_group_fd);\n \n /**\n+ * @deprecated\n * Map memory region for use with VFIO.\n *\n * @note Require at least one device to be attached at the time of\n@@ -210,11 +211,12 @@ rte_vfio_clear_group(int vfio_group_fd);\n * 0 if success.\n * -1 on error.\n */\n-int\n+int __rte_deprecated\n rte_vfio_dma_map(uint64_t vaddr, uint64_t iova, uint64_t len);\n \n \n /**\n+ * @deprecated\n * Unmap memory region from VFIO.\n *\n * @param vaddr\n@@ -231,7 +233,7 @@ rte_vfio_dma_map(uint64_t vaddr, uint64_t iova, uint64_t len);\n * -1 on error.\n */\n \n-int\n+int __rte_deprecated\n rte_vfio_dma_unmap(uint64_t vaddr, uint64_t iova, uint64_t len);\n /**\n * Parse IOMMU group number for a device\n", "prefixes": [ "v2", "6/6" ] }