get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2195296,
    "url": "http://patchwork.ozlabs.org/api/patches/2195296/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20260210-bpf-xdp-meta-rxcksum-v1-1-e5d55caa0541@kernel.org/",
    "project": {
        "id": 46,
        "url": "http://patchwork.ozlabs.org/api/projects/46/?format=api",
        "name": "Intel Wired Ethernet development",
        "link_name": "intel-wired-lan",
        "list_id": "intel-wired-lan.osuosl.org",
        "list_email": "intel-wired-lan@osuosl.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20260210-bpf-xdp-meta-rxcksum-v1-1-e5d55caa0541@kernel.org>",
    "list_archive_url": null,
    "date": "2026-02-10T17:21:47",
    "name": "[bpf-next,1/5] netlink: specs: Add XDP RX checksum capability to XDP metadata specs",
    "commit_ref": null,
    "pull_url": null,
    "state": "handled-elsewhere",
    "archived": false,
    "hash": "6e014873ced853c8b11d8ab0d9e8894ee2d665b1",
    "submitter": {
        "id": 76007,
        "url": "http://patchwork.ozlabs.org/api/people/76007/?format=api",
        "name": "Lorenzo Bianconi",
        "email": "lorenzo@kernel.org"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20260210-bpf-xdp-meta-rxcksum-v1-1-e5d55caa0541@kernel.org/mbox/",
    "series": [
        {
            "id": 491715,
            "url": "http://patchwork.ozlabs.org/api/series/491715/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/list/?series=491715",
            "date": "2026-02-10T17:21:46",
            "name": "Add the the capability to load HW RX checsum in eBPF programs",
            "version": 1,
            "mbox": "http://patchwork.ozlabs.org/series/491715/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/2195296/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2195296/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<intel-wired-lan-bounces@osuosl.org>",
        "X-Original-To": [
            "incoming@patchwork.ozlabs.org",
            "intel-wired-lan@lists.osuosl.org"
        ],
        "Delivered-To": [
            "patchwork-incoming@legolas.ozlabs.org",
            "intel-wired-lan@lists.osuosl.org"
        ],
        "Authentication-Results": [
            "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=osuosl.org header.i=@osuosl.org header.a=rsa-sha256\n header.s=default header.b=LqFxHHQi;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=osuosl.org\n (client-ip=2605:bc80:3010::137; helo=smtp4.osuosl.org;\n envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=patchwork.ozlabs.org)"
        ],
        "Received": [
            "from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4f9Szq3qdmz1xwG\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 04:22:15 +1100 (AEDT)",
            "from localhost (localhost [127.0.0.1])\n\tby smtp4.osuosl.org (Postfix) with ESMTP id 76FB0407A2;\n\tTue, 10 Feb 2026 17:22:13 +0000 (UTC)",
            "from smtp4.osuosl.org ([127.0.0.1])\n by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id azFt3ZGH0s48; Tue, 10 Feb 2026 17:22:11 +0000 (UTC)",
            "from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp4.osuosl.org (Postfix) with ESMTP id C1A0440702;\n\tTue, 10 Feb 2026 17:22:11 +0000 (UTC)",
            "from smtp1.osuosl.org (smtp1.osuosl.org [140.211.166.138])\n by lists1.osuosl.org (Postfix) with ESMTP id 53484F2\n for <intel-wired-lan@lists.osuosl.org>; Tue, 10 Feb 2026 17:22:10 +0000 (UTC)",
            "from localhost (localhost [127.0.0.1])\n by smtp1.osuosl.org (Postfix) with ESMTP id 389EE83E8E\n for <intel-wired-lan@lists.osuosl.org>; Tue, 10 Feb 2026 17:22:10 +0000 (UTC)",
            "from smtp1.osuosl.org ([127.0.0.1])\n by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id 3uZHn6-0gFt0 for <intel-wired-lan@lists.osuosl.org>;\n Tue, 10 Feb 2026 17:22:09 +0000 (UTC)",
            "from tor.source.kernel.org (tor.source.kernel.org\n [IPv6:2600:3c04:e001:324:0:1991:8:25])\n by smtp1.osuosl.org (Postfix) with ESMTPS id 1260883E9D\n for <intel-wired-lan@lists.osuosl.org>; Tue, 10 Feb 2026 17:22:08 +0000 (UTC)",
            "from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58])\n by tor.source.kernel.org (Postfix) with ESMTP id C357260136;\n Tue, 10 Feb 2026 17:22:07 +0000 (UTC)",
            "by smtp.kernel.org (Postfix) with ESMTPSA id ED1ACC19421;\n Tue, 10 Feb 2026 17:22:06 +0000 (UTC)"
        ],
        "X-Virus-Scanned": [
            "amavis at osuosl.org",
            "amavis at osuosl.org"
        ],
        "X-Comment": "SPF check N/A for local connections - client-ip=140.211.166.142;\n helo=lists1.osuosl.org; envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=<UNKNOWN> ",
        "DKIM-Filter": [
            "OpenDKIM Filter v2.11.0 smtp4.osuosl.org C1A0440702",
            "OpenDKIM Filter v2.11.0 smtp1.osuosl.org 1260883E9D"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1770744131;\n\tbh=ubzQ0rVea6jQ8SSUo7pJh01SZd8kW5pc2bTQTc7mXlA=;\n\th=From:Date:References:In-Reply-To:To:Cc:Subject:List-Id:\n\t List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe:\n\t From;\n\tb=LqFxHHQihx1bHtZL8sCeZ52pR20NIzyNt04V5YjMZChY1x1nKc5YQDmF8DwK0Dp0T\n\t D1PqW3+1xJiDm5pqYJjq9GaHrUjzEMv0n6aS3vUtbIKWeYmd+f9ch4UnAg5hXU5Bcf\n\t TfkkSnpErhftmiSYRBbHfLdx05WiMPHV6MxjBqHZT2dV1m0duCH5NqvF29dH7mZtW1\n\t AmVs8wYi0V+32Jd7bYyTlAxcdFAl+c5RrqoQEwPEYgjgeTQuGn9thPPjzUwpMcWxy3\n\t pbjJnc/Sv/216CWJYq6UTZqc9uwDt5guGeUmll/MaOifKuE3tWgbIUUVcBFDQTmujN\n\t qthHC0FdhR3iw==",
        "Received-SPF": "Pass (mailfrom) identity=mailfrom;\n client-ip=2600:3c04:e001:324:0:1991:8:25; helo=tor.source.kernel.org;\n envelope-from=lorenzo@kernel.org; receiver=<UNKNOWN>",
        "DMARC-Filter": "OpenDMARC Filter v1.4.2 smtp1.osuosl.org 1260883E9D",
        "From": "Lorenzo Bianconi <lorenzo@kernel.org>",
        "Date": "Tue, 10 Feb 2026 18:21:47 +0100",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "7bit",
        "Message-Id": "<20260210-bpf-xdp-meta-rxcksum-v1-1-e5d55caa0541@kernel.org>",
        "References": "<20260210-bpf-xdp-meta-rxcksum-v1-0-e5d55caa0541@kernel.org>",
        "In-Reply-To": "<20260210-bpf-xdp-meta-rxcksum-v1-0-e5d55caa0541@kernel.org>",
        "To": "Donald Hunter <donald.hunter@gmail.com>,\n Jakub Kicinski <kuba@kernel.org>, \"David S. Miller\" <davem@davemloft.net>,\n Eric Dumazet <edumazet@google.com>, Paolo Abeni <pabeni@redhat.com>,\n Simon Horman <horms@kernel.org>, Alexei Starovoitov <ast@kernel.org>,\n Daniel Borkmann <daniel@iogearbox.net>,\n Jesper Dangaard Brouer <hawk@kernel.org>,\n John Fastabend <john.fastabend@gmail.com>,\n Stanislav Fomichev <sdf@fomichev.me>, Andrew Lunn <andrew+netdev@lunn.ch>,\n Tony Nguyen <anthony.l.nguyen@intel.com>,\n Przemek Kitszel <przemyslaw.kitszel@intel.com>,\n Alexander Lobakin <aleksander.lobakin@intel.com>,\n Andrii Nakryiko <andrii@kernel.org>,\n Martin KaFai Lau <martin.lau@linux.dev>,\n Eduard Zingerman <eddyz87@gmail.com>, Song Liu <song@kernel.org>,\n Yonghong Song <yonghong.song@linux.dev>, KP Singh <kpsingh@kernel.org>,\n Hao Luo <haoluo@google.com>, Jiri Olsa <jolsa@kernel.org>,\n Shuah Khan <shuah@kernel.org>,\n Maciej Fijalkowski <maciej.fijalkowski@intel.com>",
        "Cc": "Jakub Sitnicki <jakub@cloudflare.com>, netdev@vger.kernel.org,\n bpf@vger.kernel.org, intel-wired-lan@lists.osuosl.org,\n linux-kselftest@vger.kernel.org, Lorenzo Bianconi <lorenzo@kernel.org>",
        "X-Mailer": "b4 0.14.2",
        "X-Mailman-Original-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=kernel.org; s=k20201202; t=1770744127;\n bh=0WWGFWpCzgWGE5YyDus76/dRNylvRmq56pm92Ny7kTc=;\n h=From:Date:Subject:References:In-Reply-To:To:Cc:From;\n b=giUudwp6XLlNVhpZKkbk9a4FGjDlrui7foBtR8trVSYT9yqtFWlirNqJvG51LBVEC\n p6I/ntf2CP68iW8zjf6N27qvD/jKYqTcqeTgua1ZOHsVU7gl/8BFRBQwEPx67s/L1o\n SpJE2OD4Js91mtY7Q2Zs4goaf1mQGlS6z8GQfmpQISGEGGDU0p71AWScaXPsTCVEPD\n tXqCCm10aP2oPE8qWz+TnySSUsDHrYMZkQmJUg6LhXbXz9dHF+57HUooK4BWLjRe/p\n RnkkKJIPSSM/6BjVXHU7M/YCnb0MCy1Xocurdst8pTKbUDGrSCMJxmtPOR7Z2E2apO\n ei89CiXZ07kyg==",
        "X-Mailman-Original-Authentication-Results": [
            "smtp1.osuosl.org;\n dmarc=pass (p=quarantine dis=none)\n header.from=kernel.org",
            "smtp1.osuosl.org;\n dkim=pass (2048-bit key,\n unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256\n header.s=k20201202 header.b=giUudwp6"
        ],
        "Subject": "[Intel-wired-lan] [PATCH bpf-next 1/5] netlink: specs: Add XDP RX\n checksum capability to XDP metadata specs",
        "X-BeenThere": "intel-wired-lan@osuosl.org",
        "X-Mailman-Version": "2.1.30",
        "Precedence": "list",
        "List-Id": "Intel Wired Ethernet Linux Kernel Driver Development\n <intel-wired-lan.osuosl.org>",
        "List-Unsubscribe": "<https://lists.osuosl.org/mailman/options/intel-wired-lan>,\n <mailto:intel-wired-lan-request@osuosl.org?subject=unsubscribe>",
        "List-Archive": "<http://lists.osuosl.org/pipermail/intel-wired-lan/>",
        "List-Post": "<mailto:intel-wired-lan@osuosl.org>",
        "List-Help": "<mailto:intel-wired-lan-request@osuosl.org?subject=help>",
        "List-Subscribe": "<https://lists.osuosl.org/mailman/listinfo/intel-wired-lan>,\n <mailto:intel-wired-lan-request@osuosl.org?subject=subscribe>",
        "Errors-To": "intel-wired-lan-bounces@osuosl.org",
        "Sender": "\"Intel-wired-lan\" <intel-wired-lan-bounces@osuosl.org>"
    },
    "content": "Introduce XDP RX checksum capability to XDP metadata specs. XDP RX\nchecksum will be use by devices capable of exposing receive checksum\nresult via bpf_xdp_metadata_rx_checksum().\nMoreover, introduce xmo_rx_checksum netdev callback in order allow the\neBPF program bounded to the device to retrieve the RX checksum result\ncomputed by the hw NIC.\n\nSigned-off-by: Lorenzo Bianconi <lorenzo@kernel.org>\n---\n Documentation/netlink/specs/netdev.yaml |  5 +++++\n include/net/xdp.h                       | 14 ++++++++++++++\n include/uapi/linux/netdev.h             |  3 +++\n net/core/xdp.c                          | 29 +++++++++++++++++++++++++++++\n tools/include/uapi/linux/netdev.h       |  3 +++\n 5 files changed, 54 insertions(+)",
    "diff": "diff --git a/Documentation/netlink/specs/netdev.yaml b/Documentation/netlink/specs/netdev.yaml\nindex 596c306ce52b8303b20680ff0cd34d4fd9db0e48..58eda634668a07860447a65d9fc2284839af6244 100644\n--- a/Documentation/netlink/specs/netdev.yaml\n+++ b/Documentation/netlink/specs/netdev.yaml\n@@ -61,6 +61,11 @@ definitions:\n         doc: |\n           Device is capable of exposing receive packet VLAN tag via\n           bpf_xdp_metadata_rx_vlan_tag().\n+      -\n+        name: checksum\n+        doc: |\n+          Device is capable of exposing receive checksum result via\n+          bpf_xdp_metadata_rx_checksum().\n   -\n     type: flags\n     name: xsk-flags\ndiff --git a/include/net/xdp.h b/include/net/xdp.h\nindex aa742f413c358575396530879af4570dc3fc18de..9ab9ac10ae2074b70618a9d4f32544d8b9a30b63 100644\n--- a/include/net/xdp.h\n+++ b/include/net/xdp.h\n@@ -586,6 +586,10 @@ void xdp_attachment_setup(struct xdp_attachment_info *info,\n \t\t\t   NETDEV_XDP_RX_METADATA_VLAN_TAG, \\\n \t\t\t   bpf_xdp_metadata_rx_vlan_tag, \\\n \t\t\t   xmo_rx_vlan_tag) \\\n+\tXDP_METADATA_KFUNC(XDP_METADATA_KFUNC_RX_CHECKSUM, \\\n+\t\t\t   NETDEV_XDP_RX_METADATA_CHECKSUM, \\\n+\t\t\t   bpf_xdp_metadata_rx_checksum, \\\n+\t\t\t   xmo_rx_checksum)\n \n enum xdp_rx_metadata {\n #define XDP_METADATA_KFUNC(name, _, __, ___) name,\n@@ -643,12 +647,22 @@ enum xdp_rss_hash_type {\n \tXDP_RSS_TYPE_L4_IPV6_SCTP_EX = XDP_RSS_TYPE_L4_IPV6_SCTP | XDP_RSS_L3_DYNHDR,\n };\n \n+enum xdp_checksum {\n+\tXDP_CHECKSUM_NONE\t\t= CHECKSUM_NONE,\n+\tXDP_CHECKSUM_UNNECESSARY\t= CHECKSUM_UNNECESSARY,\n+\tXDP_CHECKSUM_COMPLETE\t\t= CHECKSUM_COMPLETE,\n+\tXDP_CHECKSUM_PARTIAL\t\t= CHECKSUM_PARTIAL,\n+};\n+\n struct xdp_metadata_ops {\n \tint\t(*xmo_rx_timestamp)(const struct xdp_md *ctx, u64 *timestamp);\n \tint\t(*xmo_rx_hash)(const struct xdp_md *ctx, u32 *hash,\n \t\t\t       enum xdp_rss_hash_type *rss_type);\n \tint\t(*xmo_rx_vlan_tag)(const struct xdp_md *ctx, __be16 *vlan_proto,\n \t\t\t\t   u16 *vlan_tci);\n+\tint\t(*xmo_rx_checksum)(const struct xdp_md *ctx,\n+\t\t\t\t   enum xdp_checksum *ip_summed,\n+\t\t\t\t   u32 *cksum_meta);\n };\n \n #ifdef CONFIG_NET\ndiff --git a/include/uapi/linux/netdev.h b/include/uapi/linux/netdev.h\nindex e0b579a1df4f2126acec6c44c299e97bbbefe640..d20da430cfd57bc26b5ea2f406c27b48d8a81693 100644\n--- a/include/uapi/linux/netdev.h\n+++ b/include/uapi/linux/netdev.h\n@@ -47,11 +47,14 @@ enum netdev_xdp_act {\n  *   hash via bpf_xdp_metadata_rx_hash().\n  * @NETDEV_XDP_RX_METADATA_VLAN_TAG: Device is capable of exposing receive\n  *   packet VLAN tag via bpf_xdp_metadata_rx_vlan_tag().\n+ * @NETDEV_XDP_RX_METADATA_CHECKSUM: Device is capable of exposing receive\n+ *   checksum result via bpf_xdp_metadata_rx_checksum().\n  */\n enum netdev_xdp_rx_metadata {\n \tNETDEV_XDP_RX_METADATA_TIMESTAMP = 1,\n \tNETDEV_XDP_RX_METADATA_HASH = 2,\n \tNETDEV_XDP_RX_METADATA_VLAN_TAG = 4,\n+\tNETDEV_XDP_RX_METADATA_CHECKSUM = 8,\n };\n \n /**\ndiff --git a/net/core/xdp.c b/net/core/xdp.c\nindex fee6d080ee85fc2d278bfdddfd1365633058ec06..e51346ad3031f28d11c11f8205da6cd954da82de 100644\n--- a/net/core/xdp.c\n+++ b/net/core/xdp.c\n@@ -961,6 +961,35 @@ __bpf_kfunc int bpf_xdp_metadata_rx_vlan_tag(const struct xdp_md *ctx,\n \treturn -EOPNOTSUPP;\n }\n \n+/**\n+ * bpf_xdp_metadata_rx_checksum - Read XDP frame RX checksum.\n+ * @ctx: XDP context pointer.\n+ * @ip_summed: Return value pointer indicating checksum result.\n+ * @cksum_meta: Return value pointer indicating checksum result metadata.\n+ *\n+ * In case of success, ``ip_summed`` is set to the RX checksum result. Possible\n+ * values are:\n+ * ``XDP_CHECKSUM_NONE``\n+ * ``XDP_CHECKSUM_UNNECESSARY``\n+ * ``XDP_CHECKSUM_COMPLETE``\n+ * ``XDP_CHECKSUM_PARTIAL``\n+ *\n+ * In case of success, ``cksum_meta`` contains the hw computed checksum value\n+ * for ``XDP_CHECKSUM_COMPLETE`` or the ``csum_level`` for\n+ * ``XDP_CHECKSUM_UNNECESSARY``. It is set to 0 for ``XDP_CHECKSUM_NONE`` and\n+ * ``XDP_CHECKSUM_PARTIAL``.\n+ *\n+ * Return:\n+ * * Returns 0 on success or ``-errno`` on error.\n+ * * ``-EOPNOTSUPP`` : means device driver does not implement kfunc\n+ * * ``-ENODATA``    : means no RX-timestamp available for this frame\n+ */\n+__bpf_kfunc int bpf_xdp_metadata_rx_checksum(const struct xdp_md *ctx,\n+\t\t\t\t\t     u8 *ip_summed, u32 *cksum_meta)\n+{\n+\treturn -EOPNOTSUPP;\n+}\n+\n __bpf_kfunc_end_defs();\n \n BTF_KFUNCS_START(xdp_metadata_kfunc_ids)\ndiff --git a/tools/include/uapi/linux/netdev.h b/tools/include/uapi/linux/netdev.h\nindex e0b579a1df4f2126acec6c44c299e97bbbefe640..d20da430cfd57bc26b5ea2f406c27b48d8a81693 100644\n--- a/tools/include/uapi/linux/netdev.h\n+++ b/tools/include/uapi/linux/netdev.h\n@@ -47,11 +47,14 @@ enum netdev_xdp_act {\n  *   hash via bpf_xdp_metadata_rx_hash().\n  * @NETDEV_XDP_RX_METADATA_VLAN_TAG: Device is capable of exposing receive\n  *   packet VLAN tag via bpf_xdp_metadata_rx_vlan_tag().\n+ * @NETDEV_XDP_RX_METADATA_CHECKSUM: Device is capable of exposing receive\n+ *   checksum result via bpf_xdp_metadata_rx_checksum().\n  */\n enum netdev_xdp_rx_metadata {\n \tNETDEV_XDP_RX_METADATA_TIMESTAMP = 1,\n \tNETDEV_XDP_RX_METADATA_HASH = 2,\n \tNETDEV_XDP_RX_METADATA_VLAN_TAG = 4,\n+\tNETDEV_XDP_RX_METADATA_CHECKSUM = 8,\n };\n \n /**\n",
    "prefixes": [
        "bpf-next",
        "1/5"
    ]
}