Show a cover letter.

GET /api/covers/86658/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 86658,
    "url": "https://patches.dpdk.org/api/covers/86658/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/cover/20210115073243.7025-1-ndabilpuram@marvell.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": "<20210115073243.7025-1-ndabilpuram@marvell.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20210115073243.7025-1-ndabilpuram@marvell.com",
    "date": "2021-01-15T07:32:40",
    "name": "[v8,0/3] fix issue with partial DMA unmap",
    "submitter": {
        "id": 1202,
        "url": "https://patches.dpdk.org/api/people/1202/?format=api",
        "name": "Nithin Dabilpuram",
        "email": "ndabilpuram@marvell.com"
    },
    "mbox": "https://patches.dpdk.org/project/dpdk/cover/20210115073243.7025-1-ndabilpuram@marvell.com/mbox/",
    "series": [
        {
            "id": 14773,
            "url": "https://patches.dpdk.org/api/series/14773/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=14773",
            "date": "2021-01-15T07:32:40",
            "name": "fix issue with partial DMA unmap",
            "version": 8,
            "mbox": "https://patches.dpdk.org/series/14773/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/covers/86658/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id C3AEEA0A02;\n\tFri, 15 Jan 2021 08:32:54 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 48097140D8F;\n\tFri, 15 Jan 2021 08:32:54 +0100 (CET)",
            "from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com\n [67.231.156.173])\n by mails.dpdk.org (Postfix) with ESMTP id A5F82140D74\n for <dev@dpdk.org>; Fri, 15 Jan 2021 08:32:52 +0100 (CET)",
            "from pps.filterd (m0045851.ppops.net [127.0.0.1])\n by mx0b-0016f401.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id\n 10F7WPO2018054; Thu, 14 Jan 2021 23:32:51 -0800",
            "from dc5-exch01.marvell.com ([199.233.59.181])\n by mx0b-0016f401.pphosted.com with ESMTP id 35ycvq1u3t-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Thu, 14 Jan 2021 23:32:51 -0800",
            "from SC-EXCH01.marvell.com (10.93.176.81) by DC5-EXCH01.marvell.com\n (10.69.176.38) with Microsoft SMTP Server (TLS) id 15.0.1497.2;\n Thu, 14 Jan 2021 23:32:50 -0800",
            "from DC5-EXCH02.marvell.com (10.69.176.39) by SC-EXCH01.marvell.com\n (10.93.176.81) with Microsoft SMTP Server (TLS) id 15.0.1497.2;\n Thu, 14 Jan 2021 23:32:49 -0800",
            "from maili.marvell.com (10.69.176.80) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server id 15.0.1497.2 via Frontend\n Transport; Thu, 14 Jan 2021 23:32:49 -0800",
            "from hyd1588t430.marvell.com (unknown [10.29.52.204])\n by maili.marvell.com (Postfix) with ESMTP id 9FE253F7040;\n Thu, 14 Jan 2021 23:32:47 -0800 (PST)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com;\n h=from : to : cc :\n subject : date : message-id : in-reply-to : references : mime-version :\n content-type; s=pfpt0220; bh=71W4g7T972rQuHUIChpyUDG+E9I7zaQ1zOC/x5GtaK8=;\n b=PBzLA9V7YYiCQsKr1y0NrOvQM7N+LEI0bCe+pwVHfbNpc5kP4jwxBvSyz9sqAeG6Szbc\n gC9c9/vr8/f1CAl6eIAtNLHFsPDuuIvMmaQxFIvkbWPtPE8B+xgert07+BDOCWKU2Riz\n f6CW2n3MV940yIAmE/OFvL9Lz+jrFUkGVIaV912xFI0BSAdf3EJf65BSfoO+D4TYuXdT\n 5xQcmTsV0A92W/EbzrSiPdHTPjrM2OWty+98Awid3NPCfL2bgLAl0GHzAMJa09mnx53h\n fC3a5HxX9CGWKeV4uRZXBmF/Eti0jcyCeZTDxLi1p6zJ54BbP51Iyb9cqcrRiaSMCtSN Sw==",
        "From": "Nithin Dabilpuram <ndabilpuram@marvell.com>",
        "To": "<anatoly.burakov@intel.com>, David Christensen <drc@linux.vnet.ibm.com>,\n <david.marchand@redhat.com>",
        "CC": "<jerinj@marvell.com>, <dev@dpdk.org>, Nithin Dabilpuram\n <ndabilpuram@marvell.com>",
        "Date": "Fri, 15 Jan 2021 13:02:40 +0530",
        "Message-ID": "<20210115073243.7025-1-ndabilpuram@marvell.com>",
        "X-Mailer": "git-send-email 2.8.4",
        "In-Reply-To": "<20201012081106.10610-1-ndabilpuram@marvell.com>",
        "References": "<20201012081106.10610-1-ndabilpuram@marvell.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain",
        "X-Proofpoint-Virus-Version": "vendor=fsecure engine=2.50.10434:6.0.343, 18.0.737\n definitions=2021-01-15_03:2021-01-15,\n 2021-01-15 signatures=0",
        "Subject": "[dpdk-dev] [PATCH v8 0/3] fix issue with partial DMA unmap",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <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 <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "Partial DMA unmap is not supported by VFIO type1 IOMMU\nin Linux. Though the return value is zero, the returned\nDMA unmap size is not same as expected size.\nSo add test case and fix to both heap triggered DMA\nmapping and user triggered DMA mapping/unmapping.\n\nRefer vfio_dma_do_unmap() in drivers/vfio/vfio_iommu_type1.c\nSnippet of comment is below.\n\n        /*\n         * vfio-iommu-type1 (v1) - User mappings were coalesced together to\n         * avoid tracking individual mappings.  This means that the granularity\n         * of the original mapping was lost and the user was allowed to attempt\n         * to unmap any range.  Depending on the contiguousness of physical\n         * memory and page sizes supported by the IOMMU, arbitrary unmaps may\n         * or may not have worked.  We only guaranteed unmap granularity\n         * matching the original mapping; even though it was untracked here,\n         * the original mappings are reflected in IOMMU mappings.  This\n         * resulted in a couple unusual behaviors.  First, if a range is not\n         * able to be unmapped, ex. a set of 4k pages that was mapped as a\n         * 2M hugepage into the IOMMU, the unmap ioctl returns success but with\n         * a zero sized unmap.  Also, if an unmap request overlaps the first\n         * address of a hugepage, the IOMMU will unmap the entire hugepage.\n         * This also returns success and the returned unmap size reflects the\n         * actual size unmapped.\n\n         * We attempt to maintain compatibility with this \"v1\" interface, but  \n         * we take control out of the hands of the IOMMU.  Therefore, an unmap \n         * request offset from the beginning of the original mapping will      \n         * return success with zero sized unmap.  And an unmap request covering\n         * the first iova of mapping will unmap the entire range.              \n\nThis behavior can be verified by using first patch and add return check for\ndma_unmap.size != len in vfio_type1_dma_mem_map()\n\nv8:\n- Add cc stable to patch 3/3\n\nv7:\n- Dropped vfio test case of patch 3/4 i.e\n  \"test: add test case to validate VFIO DMA map/unmap\"\n  as it couldn't be supported in POWER9 system.\n\nv6:\n- Fixed issue with x86-32 build introduced by v5.\n\nv5:\n- Changed vfio test in test_vfio.c to use system pages allocated from\n  heap instead of mmap() so that it comes in range of initially configured\n  window for POWER9 System.\n- Added acked-by from David for 1/4, 2/4.\n\nv4:\n- Fixed issue with patch 4/4 on x86 builds.\n\nv3:\n- Fixed external memory test case(4/4) to use system page size\n  instead of 4K.\n- Fixed check-git-log.sh issue and rebased.\n- Added acked-by from anatoly.burakov@intel.com to first 3 patches.\n\nv2: \n- Reverted earlier commit that enables mergin contiguous mapping for\n  IOVA as PA. (see 1/3)\n- Updated documentation about kernel dma mapping limits and vfio\n  module parameter.\n- Moved vfio test to test_vfio.c and handled comments from\n  Anatoly.\n\nNithin Dabilpuram (3):\n  vfio: revert changes for map contiguous areas in one go\n  vfio: fix DMA mapping granularity for type1 IOVA as VA\n  test: change external memory test to use system page sz\n\n app/test/test_external_mem.c           |  3 +-\n doc/guides/linux_gsg/linux_drivers.rst | 10 ++++\n lib/librte_eal/linux/eal_vfio.c        | 93 +++++++++++++---------------------\n lib/librte_eal/linux/eal_vfio.h        |  1 +\n 4 files changed, 49 insertions(+), 58 deletions(-)"
}