get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/50419/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 50419,
    "url": "http://patches.dpdk.org/api/patches/50419/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/cover.1550760026.git.shahafs@mellanox.com/",
    "project": {
        "id": 1,
        "url": "http://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": "<cover.1550760026.git.shahafs@mellanox.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/cover.1550760026.git.shahafs@mellanox.com",
    "date": "2019-02-21T14:50:43",
    "name": "[v2,0/6] introduce DMA memory mapping for external memory",
    "commit_ref": null,
    "pull_url": null,
    "state": null,
    "archived": false,
    "hash": null,
    "submitter": {
        "id": 634,
        "url": "http://patches.dpdk.org/api/people/634/?format=api",
        "name": "Shahaf Shuler",
        "email": "shahafs@mellanox.com"
    },
    "delegate": null,
    "mbox": "http://patches.dpdk.org/project/dpdk/patch/cover.1550760026.git.shahafs@mellanox.com/mbox/",
    "series": [],
    "comments": "http://patches.dpdk.org/api/patches/50419/comments/",
    "check": "pending",
    "checks": "http://patches.dpdk.org/api/patches/50419/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 571E231FC;\n\tThu, 21 Feb 2019 15:51:15 +0100 (CET)",
            "from mellanox.co.il (mail-il-dmz.mellanox.com [193.47.165.129])\n\tby dpdk.org (Postfix) with ESMTP id 811342BDB\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 x1LEp2ln022817;\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:43 +0200",
        "Message-Id": "<cover.1550760026.git.shahafs@mellanox.com>",
        "X-Mailer": "git-send-email 2.12.0",
        "In-Reply-To": "<cover.1550048187.git.shahafs@mellanox.com>",
        "References": "<cover.1550048187.git.shahafs@mellanox.com>",
        "Subject": "[dpdk-dev] [PATCH v2 0/6] introduce DMA memory mapping for external\n\tmemory",
        "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": "The DPDK APIs expose 3 different modes to work with memory used for DMA:\n\n1. Use the DPDK owned memory (backed by the DPDK provided hugepages).\nThis memory is allocated by the DPDK libraries, included in the DPDK\nmemory system (memseg lists) and automatically DMA mapped by the DPDK\nlayers.\n\n2. Use memory allocated by the user and register to the DPDK memory\nsystems. Upon registration of memory, the DPDK layers will DMA map it\nto all needed devices. After registration, allocation of this memory\nwill be done with rte_*malloc APIs.\n\n3. Use memory allocated by the user and not registered to the DPDK memory\nsystem. This is for users who wants to have tight control on this\nmemory (e.g. avoid the rte_malloc header).\nThe user should create a memory, register it through rte_extmem_register\nAPI, and call DMA map function in order to register such memory to\nthe different devices.\n\nThe scope of the patch focus on #3 above.\n\nCurrently the only way to map external memory is through VFIO\n(rte_vfio_dma_map). While VFIO is common, there are other vendors\nwhich use different ways to map memory (e.g. Mellanox and NXP).\n\nThe work in this patch moves the DMA mapping to vendor agnostic APIs.\nDevice level DMA map and unmap APIs were added. Implementation of those\nAPIs was done currently only for PCI devices.\n\nFor PCI bus devices, the pci driver can expose its own map and unmap\nfunctions to be used for the mapping. In case the driver doesn't provide\nany, the memory will be mapped, if possible, to IOMMU through VFIO APIs.\n\nApplication usage with those APIs is quite simple:\n* allocate memory\n* call rte_extmem_register on the memory chunk.\n* take a device, and query its rte_device.\n* call the device specific mapping function for this device.\n\nFuture work will deprecate the rte_vfio_dma_map and rte_vfio_dma_unmap\nAPIs, leaving the rte device APIs as the preferred option for the user.\n\nOn v2:\n - Added warn in release notes about the API change in vfio.\n - Moved function doc to prototype declaration.\n - Used dma_map and dma_unmap instead of map and unmap.\n - Used RTE_VFIO_DEFAULT_CONTAINER_FD instead of -1 fixed value.\n - Moved bus function to eal_common_dev.c and renamed them properly.\n - Changed eth device iterator to use RTE_DEV_FOREACH.\n - Enforced memory is registered with rte_extmem_* prior to mapping.\n - Used EEXIST as the only possible return value from type1 vfio IOMMU mapping.\n\n[1] https://patches.dpdk.org/patch/47796/\n\nShahaf Shuler (6):\n  vfio: allow DMA map of memory for the default vfio fd\n  vfio: don't fail to DMA map if memory is already mapped\n  bus: introduce device level DMA memory mapping\n  net/mlx5: refactor external memory registration\n  net/mlx5: support PCI device DMA map and unmap\n  doc: deprecate VFIO DMA map APIs\n\n doc/guides/prog_guide/env_abstraction_layer.rst |   2 +-\n doc/guides/rel_notes/deprecation.rst            |   4 +\n doc/guides/rel_notes/release_19_05.rst          |   3 +\n drivers/bus/pci/pci_common.c                    |  48 ++++\n drivers/bus/pci/rte_bus_pci.h                   |  40 ++++\n drivers/net/mlx5/mlx5.c                         |   2 +\n drivers/net/mlx5/mlx5_mr.c                      | 221 ++++++++++++++++---\n drivers/net/mlx5/mlx5_rxtx.h                    |   5 +\n lib/librte_eal/common/eal_common_dev.c          |  29 +++\n lib/librte_eal/common/include/rte_bus.h         |  44 ++++\n lib/librte_eal/common/include/rte_dev.h         |  43 ++++\n lib/librte_eal/common/include/rte_vfio.h        |  14 +-\n lib/librte_eal/linuxapp/eal/eal_vfio.c          |  22 +-\n lib/librte_eal/rte_eal_version.map              |   2 +\n 14 files changed, 441 insertions(+), 38 deletions(-)",
    "diff": null,
    "prefixes": [
        "v2",
        "0/6"
    ]
}