Show a cover letter.

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

{
    "id": 126844,
    "url": "http://patches.dpdk.org/api/covers/126844/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20230515064700.624054-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": "<20230515064700.624054-1-miao.li@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230515064700.624054-1-miao.li@intel.com",
    "date": "2023-05-15T06:46:56",
    "name": "[v1,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/20230515064700.624054-1-miao.li@intel.com/mbox/",
    "series": [
        {
            "id": 27992,
            "url": "http://patches.dpdk.org/api/series/27992/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=27992",
            "date": "2023-05-15T06:46:56",
            "name": "Support VFIO sparse mmap in PCI bus",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/27992/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/126844/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 E101642B0E;\n\tMon, 15 May 2023 08:47:21 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id BD35B40687;\n\tMon, 15 May 2023 08:47:21 +0200 (CEST)",
            "from mga06.intel.com (mga06b.intel.com [134.134.136.31])\n by mails.dpdk.org (Postfix) with ESMTP id C228240395\n for <dev@dpdk.org>; Mon, 15 May 2023 08:47:20 +0200 (CEST)",
            "from orsmga003.jf.intel.com ([10.7.209.27])\n by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 14 May 2023 23:47:19 -0700",
            "from dpdk-limiao-icelake.sh.intel.com ([10.67.111.26])\n by orsmga003.jf.intel.com with ESMTP; 14 May 2023 23:47:16 -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=1684133240; x=1715669240;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=NjeaE0TtYzmbMPPEjfnDYppylsxAYX99PrfQlFgSY0E=;\n b=kcPFPCdLYZKk17QGtdtbLXCNky1vx1EOkgOKRDd/HFNFEikO2ZEOB2NO\n q1ZCCcayU33eZenWEcbSCyOHYymSWV4v5D623sQgbHJK4iRoXx75pN24c\n FAF+DlQW5W53hWGd71cI1Dj37JBKGyf6TyxIigX83UmxkdFqb4ZE0+Uub\n W1xemBnkzEDnp9x5eYQcWSKP50PNtykVkPY/5GOlQvReHQVYDCUSUtdau\n B2FvX1NXGB5NWXwLgw9abVZYK8t3l6fWWaWR2wzDHQxeFRBKugZi77go5\n x+oXNoQaUwoX0w0bUCpMlvOUn5uIYhlqdjZh6njlLtAT/mKvOMHFkvDzV Q==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6600,9927,10710\"; a=\"414520095\"",
            "E=Sophos;i=\"5.99,275,1677571200\"; d=\"scan'208\";a=\"414520095\"",
            "E=McAfee;i=\"6600,9927,10710\"; a=\"651306323\"",
            "E=Sophos;i=\"5.99,275,1677571200\"; d=\"scan'208\";a=\"651306323\""
        ],
        "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 v1 0/4] Support VFIO sparse mmap in PCI bus",
        "Date": "Mon, 15 May 2023 06:46:56 +0000",
        "Message-Id": "<20230515064700.624054-1-miao.li@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20230418053012.10667-1-chenbo.xia@intel.com>",
        "References": "<20230418053012.10667-1-chenbo.xia@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\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 lib/eal/include/rte_vfio.h       |   1 -\n 10 files changed, 482 insertions(+), 91 deletions(-)"
}