Show a cover letter.

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

{
    "id": 126850,
    "url": "http://patches.dpdk.org/api/covers/126850/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20230515094124.722431-1-miao.li@intel.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": "<20230515094124.722431-1-miao.li@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230515094124.722431-1-miao.li@intel.com",
    "date": "2023-05-15T09:41:20",
    "name": "[v2,0/4] Support VFIO sparse mmap in PCI bus",
    "submitter": {
        "id": 2220,
        "url": "http://patches.dpdk.org/api/people/2220/?format=api",
        "name": "Li, Miao",
        "email": "miao.li@intel.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/20230515094124.722431-1-miao.li@intel.com/mbox/",
    "series": [
        {
            "id": 27994,
            "url": "http://patches.dpdk.org/api/series/27994/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=27994",
            "date": "2023-05-15T09:41:20",
            "name": "Support VFIO sparse mmap in PCI bus",
            "version": 2,
            "mbox": "http://patches.dpdk.org/series/27994/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/126850/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 88AFF42B11;\n\tMon, 15 May 2023 11:41:37 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 0E07D40687;\n\tMon, 15 May 2023 11:41:37 +0200 (CEST)",
            "from mga17.intel.com (mga17.intel.com [192.55.52.151])\n by mails.dpdk.org (Postfix) with ESMTP id 763FB40395\n for <dev@dpdk.org>; Mon, 15 May 2023 11:41:35 +0200 (CEST)",
            "from fmsmga004.fm.intel.com ([10.253.24.48])\n by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 15 May 2023 02:41:35 -0700",
            "from dpdk-limiao-icelake.sh.intel.com ([10.67.111.26])\n by fmsmga004.fm.intel.com with ESMTP; 15 May 2023 02:41:32 -0700"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1684143696; x=1715679696;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=7AZG4k9sgpFiz6RrMTkNxBrWboPd2uK9kmU/WhS3ypo=;\n b=j7M5/0UMUcUm7kMtmiK7LDAT1Y+0TOwWAAf7rch2tL/0XkD6rOeEFu3f\n kbJqx4DLK8hMotyWToNeiX6bqBMSPUjQ3cRnzST5SvANUKknmKDKL30sy\n JIwHVnT2kV3imzB9y+Omp58qZdBUsPTLDe57fkamvkhije13unoFlyYTv\n 7FNwxt8LUYFveDLY5sDsWP6j35wfoVVJlpGjdapSUcaGrfjdD5Wxw/CCe\n HXSclBaLWOuYrWU607q5CQDW6S5kwQvU+BRxK/gEeZGHdAqe79m6XqGNk\n f1NopppU7zcDujrOc2dicAnn/Cwk5RwXWTcFyFGLklF4/Y9MA2gWMp8pC g==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6600,9927,10710\"; a=\"331527292\"",
            "E=Sophos;i=\"5.99,276,1677571200\"; d=\"scan'208\";a=\"331527292\"",
            "E=McAfee;i=\"6600,9927,10710\"; a=\"770553383\"",
            "E=Sophos;i=\"5.99,276,1677571200\"; d=\"scan'208\";a=\"770553383\""
        ],
        "X-ExtLoop1": "1",
        "From": "Miao Li <miao.li@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "skori@marvell.com, thomas@monjalon.net, david.marchand@redhat.com,\n ferruh.yigit@amd.com, chenbo.xia@intel.com, yahui.cao@intel.com",
        "Subject": "[PATCH v2 0/4] Support VFIO sparse mmap in PCI bus",
        "Date": "Mon, 15 May 2023 09:41:20 +0000",
        "Message-Id": "<20230515094124.722431-1-miao.li@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20230515064700.624054-5-miao.li@intel.com>",
        "References": "<20230515064700.624054-5-miao.li@intel.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "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"
    },
    "content": "This series introduces a VFIO standard capability, called sparse\nmmap to PCI bus. In linux kernel, it's defined as\nVFIO_REGION_INFO_CAP_SPARSE_MMAP. Sparse mmap means instead of\nmmap whole BAR region into DPDK process, only mmap part of the\nBAR region after getting sparse mmap information from kernel.\nFor the rest of BAR region that is not mmap-ed, DPDK process\ncan use pread/pwrite system calls to access. Sparse mmap is\nuseful when kernel does not want userspace to mmap whole BAR\nregion, or kernel wants to control over access to specific BAR\nregion. Vendors can choose to enable this feature or not for\ntheir devices in their specific kernel modules.\n\nIn this patchset:\n\nPatch 1-3 is mainly for introducing BAR access APIs so that\ndriver could use them to access specific BAR using pread/pwrite\nsystem calls when part of the BAR is not mmap-able. Patch 4\nadds the VFIO sparse mmap support finally.\n\nv2:\n1. add PCI device internal structure in bus/pci/windows/pci.c\n2. fix parameter type error\n\nChenbo Xia (3):\n  bus/pci: introduce an internal representation of PCI device\n  bus/pci: avoid depending on private value in kernel source\n  bus/pci: introduce helper for MMIO read and write\n\nMiao Li (1):\n  bus/pci: add VFIO sparse mmap support\n\n drivers/bus/pci/bsd/pci.c        |  35 +++-\n drivers/bus/pci/linux/pci.c      |  78 +++++--\n drivers/bus/pci/linux/pci_init.h |  14 +-\n drivers/bus/pci/linux/pci_uio.c  |  22 ++\n drivers/bus/pci/linux/pci_vfio.c | 335 +++++++++++++++++++++++++------\n drivers/bus/pci/pci_common.c     |  12 +-\n drivers/bus/pci/private.h        |  25 ++-\n drivers/bus/pci/rte_bus_pci.h    |  48 +++++\n drivers/bus/pci/version.map      |   3 +\n drivers/bus/pci/windows/pci.c    |  14 +-\n lib/eal/include/rte_vfio.h       |   1 -\n 11 files changed, 491 insertions(+), 96 deletions(-)"
}