Show a cover letter.

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

{
    "id": 128266,
    "url": "http://patches.dpdk.org/api/covers/128266/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20230607042425.30714-1-nipun.gupta@amd.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": "<20230607042425.30714-1-nipun.gupta@amd.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230607042425.30714-1-nipun.gupta@amd.com",
    "date": "2023-06-07T04:24:21",
    "name": "[v8,0/4] Support AMD CDX bus",
    "submitter": {
        "id": 2928,
        "url": "http://patches.dpdk.org/api/people/2928/?format=api",
        "name": "Gupta, Nipun",
        "email": "nipun.gupta@amd.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/20230607042425.30714-1-nipun.gupta@amd.com/mbox/",
    "series": [
        {
            "id": 28384,
            "url": "http://patches.dpdk.org/api/series/28384/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=28384",
            "date": "2023-06-07T04:24:21",
            "name": "Support AMD CDX bus",
            "version": 8,
            "mbox": "http://patches.dpdk.org/series/28384/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/128266/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 AF7E942C46;\n\tWed,  7 Jun 2023 06:24:42 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 842D5410F6;\n\tWed,  7 Jun 2023 06:24:42 +0200 (CEST)",
            "from NAM12-DM6-obe.outbound.protection.outlook.com\n (mail-dm6nam12on2052.outbound.protection.outlook.com [40.107.243.52])\n by mails.dpdk.org (Postfix) with ESMTP id B16EB40A84\n for <dev@dpdk.org>; Wed,  7 Jun 2023 06:24:41 +0200 (CEST)",
            "from CY5PR22CA0037.namprd22.prod.outlook.com (2603:10b6:930:1d::7)\n by DS7PR12MB5958.namprd12.prod.outlook.com (2603:10b6:8:7d::20) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.33; Wed, 7 Jun\n 2023 04:24:39 +0000",
            "from CY4PEPF0000EE3C.namprd03.prod.outlook.com\n (2603:10b6:930:1d:cafe::a) by CY5PR22CA0037.outlook.office365.com\n (2603:10b6:930:1d::7) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6477.19 via Frontend\n Transport; Wed, 7 Jun 2023 04:24:39 +0000",
            "from SATLEXMB03.amd.com (165.204.84.17) by\n CY4PEPF0000EE3C.mail.protection.outlook.com (10.167.242.16) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id\n 15.20.6477.13 via Frontend Transport; Wed, 7 Jun 2023 04:24:38 +0000",
            "from SATLEXMB05.amd.com (10.181.40.146) by SATLEXMB03.amd.com\n (10.181.40.144) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Tue, 6 Jun\n 2023 23:24:38 -0500",
            "from SATLEXMB04.amd.com (10.181.40.145) by SATLEXMB05.amd.com\n (10.181.40.146) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Tue, 6 Jun\n 2023 23:24:38 -0500",
            "from xhdipdslab41.xilinx.com (10.180.168.240) by SATLEXMB04.amd.com\n (10.181.40.145) with Microsoft SMTP Server id 15.1.2375.34 via\n Frontend Transport; Tue, 6 Jun 2023 23:24:35 -0500"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=gMFz7v9KOwdymDcPZ4rH2vUlKafT4M8uO3jT+xP9qDOBd4ztGbZmxnPvDS6x4Grqp74MIxm41QmiSHOkFRcyrE+XzHqwVuGbLrhsQQTMIpPh9uIqI3B+6dR+STThOuXDM/NN9ekYmSM9hvyEaZeprASpQBHLwFuonMt4F2zaAN+C9VUGZ6PSXXYsIAWujWj7wXmHrwibaefN1HHIIvgwUgWXXJ4O6A5w4rTYamVA1/ur5i6VDkvSIpVoa8khHrMMEDkGS1NUh4wHVqo/a2vV9GjAempG9gbufQSYbeUEaJFV+OwmNcP+JbzXT5JrGUT92vYPgjb0NbptAkq2SJ/XvA==",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=omVEEjAkKoX/K/10u54IXc44aaAKj2TLJQwnj/F9FoE=;\n b=PJXwIUYI3+KRYdlyTGVHa151G+k11NYfHJZgLVQnCm7PwmoER56yOeQTeFUqPoIx0cmnzzCLIUP28O0S2dDpO1Wt1om+SepPGtvlHsB50OHf/zxPylOZckuJRgka78oBpHFxf73fpFKsHowEClwwxdKtWxwJ1yHeouBZxUg/PqcxWwOt4Oc/wgwX0BfSS9f0BCjIBgP+x7tYVML9yoGx3ucLK4Km4By89ge6hPUVjWsB61TdW0G6jO5vKdOGXqnBFwirqwfkUWJeZAK4NnRUMEwwdoVcJ2wMVejLtaBtNfhRBfjbIujk3J7H7dza6CtZ1gq+DeboyDpOGv/jSg8tAw==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 165.204.84.17) smtp.rcpttodomain=dpdk.org smtp.mailfrom=amd.com; dmarc=pass\n (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com;\n dkim=none (message not signed); arc=none",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=omVEEjAkKoX/K/10u54IXc44aaAKj2TLJQwnj/F9FoE=;\n b=SzLhAZL4sHN6k79mG9Sbi3O7suvHoT5mlO9Gsbdrxd56XDp52gK/4FvBhk2LyEYemEkFCHKqpE9kuXWaU/Yp+AXVH4zGzi2nm1/AFLBXNUTEPFOJWRXdg0IPKOnOkNmrLJZSC0l08wI3kiFZCBJ4ZGCWzTmZ/24yVHhy/ddfeOw=",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 165.204.84.17)\n smtp.mailfrom=amd.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=amd.com;",
        "Received-SPF": "Pass (protection.outlook.com: domain of amd.com designates\n 165.204.84.17 as permitted sender) receiver=protection.outlook.com;\n client-ip=165.204.84.17; helo=SATLEXMB03.amd.com; pr=C",
        "From": "Nipun Gupta <nipun.gupta@amd.com>",
        "To": "<dev@dpdk.org>, <thomas@monjalon.net>, <david.marchand@redhat.com>,\n <hkalra@marvell.com>, <anatoly.burakov@intel.com>,\n <stephen@networkplumber.org>",
        "CC": "<ferruh.yigit@amd.com>, <harpreet.anand@amd.com>,\n <nikhil.agarwal@amd.com>, Nipun Gupta <nipun.gupta@amd.com>",
        "Subject": "[PATCH v8 0/4] Support AMD CDX bus",
        "Date": "Wed, 7 Jun 2023 09:54:21 +0530",
        "Message-ID": "<20230607042425.30714-1-nipun.gupta@amd.com>",
        "X-Mailer": "git-send-email 2.17.1",
        "In-Reply-To": "<20230124140746.594066-1-nipun.gupta@amd.com>",
        "References": "<20230124140746.594066-1-nipun.gupta@amd.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-TrafficTypeDiagnostic": "CY4PEPF0000EE3C:EE_|DS7PR12MB5958:EE_",
        "X-MS-Office365-Filtering-Correlation-Id": "0de2ba36-4453-48f9-4f08-08db670f1bb4",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n WuNyscQtzzL2Hoi+ZdEU3CPMqbyOiNN/khCXN24IoJb1qVLG4IrhQg8x/g1pztwxXdvqg77nMWJJwcPpV0wcdi/by81JGA9KNXU/F3RabefFTtr1KVMVykxe1xD4Ho8IIUdmja+7SUwC7PMRqhUwxJz+fRhQbUyV88vHjcIQhnFlRvy6CnhtPpfpx5cOQgZhDurqAly9P8iUjogaX4QFbE1XrFeRZfQNivv8BUpEBSarbhP1lk1foA/GShQW2ZjGlfgE6KaROtQyGWfZAtzmhPOT42OPYNwU6RpKbpor3J+QAYYenolJSxvPVH/0KY9ktSGWELgw1GT+tQNnxKqZWOTShRZscm/mwrm9JW7Mpeaj6Gm8CHRhACTH+Y+HFnFLNVvVZI0ZBh9h74rD0G2fuAj5MbLIaB1MuUYhpdepuN5CgKg1mD4k5EzB3NaOUW381N6NTK7/tTcSfP8HA9Rr7PgBxrEVPiq1mP3ETtkSpsoWySeS6BCyOmODxC8ICPU2W7R3jAQR+/QtsoqHbTvzlfvw9b6fHk/OybqESHHN/a1FXFW0nakCKvn5QEjd96/078zBNQysyceUgtMv8xOmBnmGLHFf+JbltjnHs+LUdSNJrQeqa6MBw8/91fFQefwNrh2eCB9w83DeDHx0l+bcM9KzhkR/LbysTkj0bI28JvC1Qg9f1puFXDEQgQmO6aPoxDvlxewt/RwNcJgwtnIoK2YhUPR88cb9IXD9ZX9lJJvdo3ucoLOgV9712guuhWR9NHmFHwYhx1XuVMbhHv/NbkcRO6PVSX3I5Na6++UwVeE=",
        "X-Forefront-Antispam-Report": "CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:SATLEXMB03.amd.com; PTR:InfoDomainNonexistent; CAT:NONE;\n SFS:(13230028)(4636009)(136003)(396003)(346002)(376002)(39860400002)(451199021)(36840700001)(46966006)(40470700004)(1076003)(40460700003)(26005)(966005)(36860700001)(36756003)(81166007)(336012)(426003)(83380400001)(47076005)(82310400005)(86362001)(82740400003)(356005)(186003)(40480700001)(2616005)(8676002)(41300700001)(44832011)(110136005)(54906003)(4326008)(478600001)(70586007)(2906002)(316002)(8936002)(70206006)(5660300002)(6666004)(36900700001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "amd.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "07 Jun 2023 04:24:38.8935 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 0de2ba36-4453-48f9-4f08-08db670f1bb4",
        "X-MS-Exchange-CrossTenant-Id": "3dd8961f-e488-4e60-8e11-a82d994e183d",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17];\n Helo=[SATLEXMB03.amd.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n CY4PEPF0000EE3C.namprd03.prod.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "DS7PR12MB5958",
        "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": "The CDX devices are memory mapped on system bus for embedded CPUs.\n\nIt uses sysfs interface and the vfio-cdx driver to discover\nand initialize the CDX devices.\n\nThe CDX bus and VFIO support is available at Xilinx/AMD open source tree:\nhttps://github.com/Xilinx/linux-xlnx (drivers/cdx/ and drivers/vfio/cdx)\n\nLinux AMD CDX bus patches has been added into linux tree:\nhttps://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/tree/drivers/cdx\n\nVFIO patches are also submitted in upstream:\nhttps://www.spinics.net/lists/kvm/msg310623.html\n\nCDX is a Hardware Architecture designed for AMD FPGA devices. It\nconsists of mechanism for interaction between FPGA, Firmware and\nthe APUs (Application CPUs).\nFirmware resides on RPU (Realtime CPUs) which interacts with\nthe FPGA program manager and the APUs. The RPU provides memory-mapped\ninterface (RPU if) which is used to communicate with APUs.\n\nVFIO CDX driver provides the CDX device resources like MMIO and interrupts\nto map to user-space. DPDK CDX bus uses sysfs interface and the vfio-cdx\ndriver to discover and initialize the CDX devices for user-space\napplications.\n\nChanges v7->v8\n- Renamed CDX_BUS_DEVICES_PATH to RTE_CDX_BUS_DEVICES_PATH\n- Renamed CDX_MAX_RESOURCE to RTE_CDX_MAX_RESOURCE\n\nChanges v6->v7\n- removed redundant references to rte_cdx_sysfs_path().\n- Fixed naming of cdx_vfio_setup_device() API from the\n  first patch itself.\n- Added dot after few sentences in comments.\n\nChanges v5->v6\n- Removed newly introduce irq_count parameter, and use num_intr\n  instead.\n- Removed rte_cdx_sysfs_path(), and directly used the macro for\n  the sysfs path.\n- Removed few unrequired param checks in multiple APIs\n- add name variable in rte_cdx_device\n- moved rte_cdx_bus from bus_cdx_driver.h to private.h\n- Other code cleanup\n\nChanges v4->v5\n- Split patch and have a separate commit for eal interrupt field\n  (irq_count) and corresponding set/get APIs (rte_intr_irq_count_set,\n  rte_intr_irq_count_get)\n- Renamed \"CDX bus\" to \"AMD CDX bus\" in documentation/commit headings\n- Removed unnecessary headers\n\nChanges v3->v4:\n- removed platform specific patch (adding config for ARM CDX)\n  from this series\n\nChanges v2->v3:\n- merged cdx bus compilation enablement in the first patch\n- fixed issue reported by check-git-log.sh\n- updated release notes\n- updated offset to uint64_t instead of off_t in cdx_map_resource\n\nChanges v1->v2:\n- Moved file rte_cdx_bus.h to internal bus_cdx_driver.h\n  and added this file to deivce_cdx_headers\n- Moved cdx.h to private.h\n- Removed rte_ prefix from the static symbols in .c files.\n\nChanges RFC->v1:\n- Marked few API's as internal which were not required\n  to be provided to user.\n\nNipun Gupta (4):\n  bus/cdx: introduce AMD CDX bus\n  bus/cdx: add DMA map and unmap support\n  bus/cdx: add support for MSI\n  bus/cdx: support plug unplug and dev iterator\n\n MAINTAINERS                            |   5 +\n doc/guides/rel_notes/release_23_07.rst |   6 +\n drivers/bus/cdx/bus_cdx_driver.h       | 192 +++++++\n drivers/bus/cdx/cdx.c                  | 666 +++++++++++++++++++++++++\n drivers/bus/cdx/cdx_logs.h             |  37 ++\n drivers/bus/cdx/cdx_vfio.c             | 598 ++++++++++++++++++++++\n drivers/bus/cdx/meson.build            |  13 +\n drivers/bus/cdx/private.h              |  53 ++\n drivers/bus/cdx/version.map            |  12 +\n drivers/bus/meson.build                |   1 +\n 10 files changed, 1583 insertions(+)\n create mode 100644 drivers/bus/cdx/bus_cdx_driver.h\n create mode 100644 drivers/bus/cdx/cdx.c\n create mode 100644 drivers/bus/cdx/cdx_logs.h\n create mode 100644 drivers/bus/cdx/cdx_vfio.c\n create mode 100644 drivers/bus/cdx/meson.build\n create mode 100644 drivers/bus/cdx/private.h\n create mode 100644 drivers/bus/cdx/version.map"
}