get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2197397,
    "url": "http://patchwork.ozlabs.org/api/patches/2197397/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/linux-pci/patch/20260217212707.2450423-13-cassel@kernel.org/",
    "project": {
        "id": 28,
        "url": "http://patchwork.ozlabs.org/api/projects/28/?format=api",
        "name": "Linux PCI development",
        "link_name": "linux-pci",
        "list_id": "linux-pci.vger.kernel.org",
        "list_email": "linux-pci@vger.kernel.org",
        "web_url": null,
        "scm_url": null,
        "webscm_url": null,
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20260217212707.2450423-13-cassel@kernel.org>",
    "list_archive_url": null,
    "date": "2026-02-17T21:27:08",
    "name": "[2/9] PCI: endpoint: Describe reserved subregions within BARs",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "f27b2e36954a28193d996289090265cc718b45fb",
    "submitter": {
        "id": 87751,
        "url": "http://patchwork.ozlabs.org/api/people/87751/?format=api",
        "name": "Niklas Cassel",
        "email": "cassel@kernel.org"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/linux-pci/patch/20260217212707.2450423-13-cassel@kernel.org/mbox/",
    "series": [
        {
            "id": 492482,
            "url": "http://patchwork.ozlabs.org/api/series/492482/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/linux-pci/list/?series=492482",
            "date": "2026-02-17T21:27:06",
            "name": "PCI: endpoint differentiate between disabled and reserved BARs",
            "version": 1,
            "mbox": "http://patchwork.ozlabs.org/series/492482/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/2197397/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2197397/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "\n <linux-pci+bounces-47509-incoming=patchwork.ozlabs.org@vger.kernel.org>",
        "X-Original-To": [
            "incoming@patchwork.ozlabs.org",
            "linux-pci@vger.kernel.org"
        ],
        "Delivered-To": "patchwork-incoming@legolas.ozlabs.org",
        "Authentication-Results": [
            "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256\n header.s=k20201202 header.b=OugIoRFY;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=2600:3c04:e001:36c::12fc:5321; helo=tor.lore.kernel.org;\n envelope-from=linux-pci+bounces-47509-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)",
            "smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org\n header.b=\"OugIoRFY\"",
            "smtp.subspace.kernel.org;\n arc=none smtp.client-ip=10.30.226.201"
        ],
        "Received": [
            "from tor.lore.kernel.org (tor.lore.kernel.org\n [IPv6:2600:3c04:e001:36c::12fc:5321])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fFt6447fgz1xpl\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 18 Feb 2026 08:27:56 +1100 (AEDT)",
            "from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby tor.lore.kernel.org (Postfix) with ESMTP id 6E878304A89E\n\tfor <incoming@patchwork.ozlabs.org>; Tue, 17 Feb 2026 21:27:49 +0000 (UTC)",
            "from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 2C6A22F5A36;\n\tTue, 17 Feb 2026 21:27:49 +0000 (UTC)",
            "from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org\n [10.30.226.201])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id 09C6B2F6193\n\tfor <linux-pci@vger.kernel.org>; Tue, 17 Feb 2026 21:27:48 +0000 (UTC)",
            "by smtp.kernel.org (Postfix) with ESMTPSA id 42949C2BC86;\n\tTue, 17 Feb 2026 21:27:47 +0000 (UTC)"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1771363669; cv=none;\n b=CNju4cRy639uexXp2Jh4ywU005fihGQ7h52xDQ5SiYBGeGKOpBskhEWoH8rqhgizGzjfbG7AGWtA1cPey86ovHsCgliBaaeWzrvMx5v5YE8OVuuiwwI3+spnHiUcp5zOJOX/4YSeX6F+7MZCu3HwkVgqzUVqklMG7OU+Lf8NVPU=",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1771363669; c=relaxed/simple;\n\tbh=VPbMv/PkjtZ3UWX+jkT8rcxLFj4fqCA1qbDMLkV3TVk=;\n\th=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:\n\t MIME-Version;\n b=GXR0/DQEf3x+GJE/VRIUb8gGOfoRgN9YQ+4RWYNId9nJWu6w2c9aaw1wjzKnOYMsv2Wc+HzrdrOdHYwqAkGoriGbeSn40mfLHxkBwujgmujoCe3yvrkOdw82zLR80foCrgkgKds7/zHyO1OTdG9G2R2fhg51VJclAYlNnBdntB4=",
        "ARC-Authentication-Results": "i=1; smtp.subspace.kernel.org;\n dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org\n header.b=OugIoRFY; arc=none smtp.client-ip=10.30.226.201",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org;\n\ts=k20201202; t=1771363668;\n\tbh=VPbMv/PkjtZ3UWX+jkT8rcxLFj4fqCA1qbDMLkV3TVk=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=OugIoRFYyKAn+8riHPrETvweCcY0vRTmbP9N3hRrjCmmFVlPpjvnioC/fzMvlRTPJ\n\t AIKveo5m0W3PoPsb5p2TvPYhe64M8mjpRSkPMK6p8qcvJ9ZDvF9DMoz9FXGYdGZzY2\n\t QrolHjSxTAY6DDCXCkXZpIgTVlnN7p4jjDPEZLoo91J5sdDV405nIwb9/VtlhS2nsC\n\t 2XNHPXnbKbpgqMVbxR6xqrjdzjcuTUqxJEzTg3VQZQ7qw4lwaaw87b6hDc8jU5cPE2\n\t YkshRZfNzMroW91N0MYownVS4b+j3JJYPa1fx5g0qo8dgMsiv7IywaDkFX5p8ryHKF\n\t OECdOqYa7SUPA==",
        "From": "Niklas Cassel <cassel@kernel.org>",
        "To": "Bjorn Helgaas <bhelgaas@google.com>",
        "Cc": "Manikanta Maddireddy <mmaddireddy@nvidia.com>,\n\tKoichiro Den <den@valinux.co.jp>,\n\tDamien Le Moal <dlemoal@kernel.org>,\n\tNiklas Cassel <cassel@kernel.org>,\n\tlinux-pci@vger.kernel.org",
        "Subject": "[PATCH 2/9] PCI: endpoint: Describe reserved subregions within BARs",
        "Date": "Tue, 17 Feb 2026 22:27:08 +0100",
        "Message-ID": "<20260217212707.2450423-13-cassel@kernel.org>",
        "X-Mailer": "git-send-email 2.53.0",
        "In-Reply-To": "<20260217212707.2450423-11-cassel@kernel.org>",
        "References": "<20260217212707.2450423-11-cassel@kernel.org>",
        "Precedence": "bulk",
        "X-Mailing-List": "linux-pci@vger.kernel.org",
        "List-Id": "<linux-pci.vger.kernel.org>",
        "List-Subscribe": "<mailto:linux-pci+subscribe@vger.kernel.org>",
        "List-Unsubscribe": "<mailto:linux-pci+unsubscribe@vger.kernel.org>",
        "MIME-Version": "1.0",
        "X-Developer-Signature": "v=1; a=openpgp-sha256; l=2441; i=cassel@kernel.org;\n h=from:subject; bh=5LxGGG8BxSoGZMMP2Trj4tSfd3JRKgXWdNZoem6Teas=;\n b=owGbwMvMwCV2MsVw8cxjvkWMp9WSGDKn3NWta6mz1rnv75ZoP+36vYY5d45syvB44j7x1aHLZ\n 5tupFSt6ChlYRDjYpAVU2Tx/eGyv7jbfcpxxTs2MHNYmUCGMHBxCsBEvjxh+MNj9adiR1JBMXfd\n xAeZzNwmtQ8YPN84vav5WicUkp8c4M7wVzyhZQd34lXLmUUmT7e9/9R8StSh9MJTRZ9TLbwXY5Y\n 95AYA",
        "X-Developer-Key": "i=cassel@kernel.org; a=openpgp;\n fpr=5ADE635C0E631CBBD5BE065A352FE6582ED9B5DA",
        "Content-Transfer-Encoding": "8bit"
    },
    "content": "From: Koichiro Den <den@valinux.co.jp>\n\nSome endpoint controllers expose platform-owned, fixed register windows\nwithin a BAR that EPF drivers must not reprogram (e.g. a BAR marked\nBAR_RESERVED). Even in that case, EPF drivers may need to reference a\nwell-defined subset of that BAR, e.g. to reuse an integrated DMA\ncontroller MMIO window as a doorbell target.\n\nIntroduce struct pci_epc_bar_rsvd_region and extend struct\npci_epc_bar_desc so EPC drivers can advertise such fixed subregions in a\ncontroller-agnostic way.\n\nNo functional change for existing users.\n\nSigned-off-by: Koichiro Den <den@valinux.co.jp>\nSigned-off-by: Niklas Cassel <cassel@kernel.org>\n---\n include/linux/pci-epc.h | 28 ++++++++++++++++++++++++++++\n 1 file changed, 28 insertions(+)",
    "diff": "diff --git a/include/linux/pci-epc.h b/include/linux/pci-epc.h\nindex c22f8a6cf9a3..f7f48f43d370 100644\n--- a/include/linux/pci-epc.h\n+++ b/include/linux/pci-epc.h\n@@ -203,6 +203,30 @@ enum pci_epc_bar_type {\n \tBAR_64BIT_UPPER,\n };\n \n+/**\n+ * enum pci_epc_bar_rsvd_region_type - type of a fixed subregion behind a BAR\n+ * @PCI_EPC_BAR_RSVD_DMA_CTRL_MMIO: Integrated DMA controller MMIO window\n+ *\n+ * BARs marked BAR_RESERVED are owned by the SoC/EPC hardware and must not be\n+ * reprogrammed by EPF drivers. Some of them still expose fixed subregions that\n+ * EPFs may want to reference (e.g. embedded doorbell fallback).\n+ */\n+enum pci_epc_bar_rsvd_region_type {\n+\tPCI_EPC_BAR_RSVD_DMA_CTRL_MMIO = 0,\n+};\n+\n+/**\n+ * struct pci_epc_bar_rsvd_region - fixed subregion behind a BAR\n+ * @type: reserved region type\n+ * @offset: offset within the BAR aperture\n+ * @size: size of the reserved region\n+ */\n+struct pci_epc_bar_rsvd_region {\n+\tenum pci_epc_bar_rsvd_region_type\ttype;\n+\tresource_size_t\t\t\t\toffset;\n+\tresource_size_t\t\t\t\tsize;\n+};\n+\n /**\n  * struct pci_epc_bar_desc - hardware description for a BAR\n  * @type: the type of the BAR\n@@ -216,11 +240,15 @@ enum pci_epc_bar_type {\n  *\t\t(If BARx is a 64-bit BAR that an EPF driver is not allowed to\n  *\t\ttouch, then both BARx and BARx+1 must be set to type\n  *\t\tBAR_RESERVED.)\n+ * @nr_rsvd_regions: number of fixed subregions described for BAR_RESERVED\n+ * @rsvd_regions: fixed subregions behind BAR_RESERVED\n  */\n struct pci_epc_bar_desc {\n \tenum pci_epc_bar_type type;\n \tu64 fixed_size;\n \tbool only_64bit;\n+\tu8 nr_rsvd_regions;\n+\tconst struct pci_epc_bar_rsvd_region *rsvd_regions;\n };\n \n /**\n",
    "prefixes": [
        "2/9"
    ]
}