get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2219313,
    "url": "http://patchwork.ozlabs.org/api/1.0/patches/2219313/?format=api",
    "project": {
        "id": 28,
        "url": "http://patchwork.ozlabs.org/api/1.0/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
    },
    "msgid": "<20260402-uid_slot-v6-2-d5ea0a14ddb9@linux.ibm.com>",
    "date": "2026-04-02T20:34:59",
    "name": "[v6,2/2] PCI: s390: Expose the UID as an arch specific PCI slot attribute",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "aed157f2a0e08a1acec275bc00e41199ddb4c740",
    "submitter": {
        "id": 78856,
        "url": "http://patchwork.ozlabs.org/api/1.0/people/78856/?format=api",
        "name": "Niklas Schnelle",
        "email": "schnelle@linux.ibm.com"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/linux-pci/patch/20260402-uid_slot-v6-2-d5ea0a14ddb9@linux.ibm.com/mbox/",
    "series": [
        {
            "id": 498550,
            "url": "http://patchwork.ozlabs.org/api/1.0/series/498550/?format=api",
            "date": "2026-04-02T20:34:57",
            "name": "PCI: s390: Expose the UID as an arch specific PCI slot attribute",
            "version": 6,
            "mbox": "http://patchwork.ozlabs.org/series/498550/mbox/"
        }
    ],
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2219313/checks/",
    "tags": {},
    "headers": {
        "Return-Path": "\n <linux-pci+bounces-51776-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=ibm.com header.i=@ibm.com header.a=rsa-sha256\n header.s=pp1 header.b=bRGcw/82;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=172.234.253.10; helo=sea.lore.kernel.org;\n envelope-from=linux-pci+bounces-51776-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)",
            "smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=ibm.com header.i=@ibm.com\n header.b=\"bRGcw/82\"",
            "smtp.subspace.kernel.org;\n arc=none smtp.client-ip=148.163.158.5",
            "smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=linux.ibm.com",
            "smtp.subspace.kernel.org;\n spf=pass smtp.mailfrom=linux.ibm.com"
        ],
        "Received": [
            "from sea.lore.kernel.org (sea.lore.kernel.org [172.234.253.10])\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 4fmttz6yMzz1yCs\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 03 Apr 2026 07:36:59 +1100 (AEDT)",
            "from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby sea.lore.kernel.org (Postfix) with ESMTP id 694A5304B4C3\n\tfor <incoming@patchwork.ozlabs.org>; Thu,  2 Apr 2026 20:35:23 +0000 (UTC)",
            "from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 443D735F185;\n\tThu,  2 Apr 2026 20:35:22 +0000 (UTC)",
            "from mx0b-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com\n [148.163.158.5])\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 AD84733EB1B;\n\tThu,  2 Apr 2026 20:35:20 +0000 (UTC)",
            "from pps.filterd (m0356516.ppops.net [127.0.0.1])\n\tby mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id\n 632EQbx04131589;\n\tThu, 2 Apr 2026 20:35:18 GMT",
            "from ppma22.wdc07v.mail.ibm.com\n (5c.69.3da9.ip4.static.sl-reverse.com [169.61.105.92])\n\tby mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4d64dgwrau-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tThu, 02 Apr 2026 20:35:17 +0000 (GMT)",
            "from pps.filterd (ppma22.wdc07v.mail.ibm.com [127.0.0.1])\n\tby ppma22.wdc07v.mail.ibm.com (8.18.1.2/8.18.1.2) with ESMTP id\n 632JqSoq005947;\n\tThu, 2 Apr 2026 20:35:17 GMT",
            "from smtprelay02.wdc07v.mail.ibm.com ([172.16.1.69])\n\tby ppma22.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4d6spybqm8-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tThu, 02 Apr 2026 20:35:17 +0000",
            "from smtpav05.dal12v.mail.ibm.com (smtpav05.dal12v.mail.ibm.com\n [10.241.53.104])\n\tby smtprelay02.wdc07v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id\n 632KZFnM12452430\n\t(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);\n\tThu, 2 Apr 2026 20:35:15 GMT",
            "from smtpav05.dal12v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id 8E93E5806A;\n\tThu,  2 Apr 2026 20:35:15 +0000 (GMT)",
            "from smtpav05.dal12v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id D4C4858052;\n\tThu,  2 Apr 2026 20:35:12 +0000 (GMT)",
            "from tuxmaker.boeblingen.de.ibm.com (unknown [9.87.85.9])\n\tby smtpav05.dal12v.mail.ibm.com (Postfix) with ESMTP;\n\tThu,  2 Apr 2026 20:35:12 +0000 (GMT)"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1775162122; cv=none;\n b=lqak28hLzPVihqO82e4AWu09eOdFY8RxtMDrNk6pzhSCDpGEs7qWmCbGgIGW1skZ89NzsSTN0PIe6BanAftuOj/EDbrUgBQ6+A9qOdMb2iH7ARIFKKwpl/p81FJ9PXb1LUYArMdQ90uwFJJzG/JM/hYr1MW/RpFc52zOINvDNLw=",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1775162122; c=relaxed/simple;\n\tbh=9lW/KExV56mrOzTTz8NmdnnniYaI9F7J5QbEzJH+UNA=;\n\th=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References:\n\t In-Reply-To:To:Cc;\n b=J9hbRbMmyakaByfSpT5iXmXolWSqqH36ZKp3cG/TevwKkLPoY6Tg53QvbX/ajSWh5yAIkQY3WjgoueuR6zPrs3N90fDdKIvAqUE9PmDpy3OI1K6quCYura+T6fugxbkhAvhk2MrzWuqGgYZJW5xZl2LDUtEbS46Wf4RL5VDtov8=",
        "ARC-Authentication-Results": "i=1; smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=linux.ibm.com;\n spf=pass smtp.mailfrom=linux.ibm.com;\n dkim=pass (2048-bit key) header.d=ibm.com header.i=@ibm.com\n header.b=bRGcw/82; arc=none smtp.client-ip=148.163.158.5",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=cc\n\t:content-transfer-encoding:content-type:date:from:in-reply-to\n\t:message-id:mime-version:references:subject:to; s=pp1; bh=UW/wB2\n\t8RU5VzzRRMul0mFvXWrhXsBhWCUaT0XL56wzc=; b=bRGcw/82Y+AhI/dLPvOSfM\n\tf5x7tvDpTaUTyDWqzgfbcMTSLv/8OiTGzXzOUTLhpy/reu+SWhUKBse4zGeQ9CpO\n\t8l+/VP1BOyyR9rvBXDWUTivKaWFxvbQ2kHzGNW3iLMqcIF3u0c7uX1+y6zyd/Q/X\n\twyQH+IsdiaxCIwPOBsgSxr8zhbxBAj2waE4E/qRKvME3LIEmk4irRQWffOWahns6\n\tAZS4peVeZKimfhCisruIQnGEsA1wk2TaguRXe1wZZ3zBMOjKEqge0Um00H/10EdI\n\tGTXzxr9vxvuXIYDses7q2ct+yHqRwGi9nmCo8bLoMt3UKCNVb50HRsrXGlrK7IEA\n\t==",
        "From": "Niklas Schnelle <schnelle@linux.ibm.com>",
        "Date": "Thu, 02 Apr 2026 22:34:59 +0200",
        "Subject": "[PATCH v6 2/2] PCI: s390: Expose the UID as an arch specific PCI\n slot attribute",
        "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",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "7bit",
        "Message-Id": "<20260402-uid_slot-v6-2-d5ea0a14ddb9@linux.ibm.com>",
        "References": "<20260402-uid_slot-v6-0-d5ea0a14ddb9@linux.ibm.com>",
        "In-Reply-To": "<20260402-uid_slot-v6-0-d5ea0a14ddb9@linux.ibm.com>",
        "To": "Bjorn Helgaas <bhelgaas@google.com>, Jonathan Corbet <corbet@lwn.net>,\n        Lukas Wunner <lukas@wunner.de>, Shuah Khan <skhan@linuxfoundation.org>",
        "Cc": "Farhan Ali <alifm@linux.ibm.com>,\n        Alexander Gordeev <agordeev@linux.ibm.com>,\n        Christian Borntraeger <borntraeger@linux.ibm.com>,\n        Gerald Schaefer <gerald.schaefer@linux.ibm.com>,\n        Gerd Bayer <gbayer@linux.ibm.com>, Heiko Carstens <hca@linux.ibm.com>,\n        Julian Ruess <julianr@linux.ibm.com>,\n        Matthew Rosato <mjrosato@linux.ibm.com>,\n        Peter Oberparleiter <oberpar@linux.ibm.com>,\n        Ramesh Errabolu <ramesh@linux.ibm.com>,\n        Sven Schnelle <svens@linux.ibm.com>,\n Vasily Gorbik <gor@linux.ibm.com>,\n        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,\n        linux-pci@vger.kernel.org, linux-s390@vger.kernel.org,\n        Niklas Schnelle <schnelle@linux.ibm.com>",
        "X-Mailer": "b4 0.14.2",
        "X-Developer-Signature": "v=1; a=openpgp-sha256; l=5422;\n i=schnelle@linux.ibm.com; h=from:subject:message-id;\n bh=9lW/KExV56mrOzTTz8NmdnnniYaI9F7J5QbEzJH+UNA=;\n b=owGbwMvMwCX2Wz534YHOJ2GMp9WSGDLPXfplmBjP+FZhet9JF95D09g62x4J7fW71FGiPk/f0\n Cd0+WShjlIWBjEuBlkxRZZFXc5+6wqmmO4J6u+AmcPKBDKEgYtTACYSysLwTy3lVWjJjoD+q+fa\n Y3dx3z12fZ9IrLvii7VTlm3XObJby53hn/5B/Y69Kw4JBrwSt91WypPtefjetCvBVmyy/x7n9NZ\n 8ZQYA",
        "X-Developer-Key": "i=schnelle@linux.ibm.com; a=openpgp;\n fpr=9DB000B2D2752030A5F72DDCAFE43F15E8C26090",
        "X-TM-AS-GCONF": "00",
        "X-Proofpoint-Reinject": "loops=2 maxloops=12",
        "X-Proofpoint-Spam-Details-Enc": "AW1haW4tMjYwNDAyMDE4MSBTYWx0ZWRfXxFCiphKZJWql\n Sfn6AgXfiAjSjvIH6r1nEEVH9c1dMaoGFeVKl1KjX1hp/yCuYX3MHEYwBw3pnsN6IfiLE5/3tRt\n o+iGh+yY5iLZ2ibhASCcC/aNMs+xZNZDeyVK1wiFJ19pPrOkFm43GiqoxPzONyMzF8e+0FdhHcu\n Wky/b3Ohsd29FCp/hbG8aa8or42IPTR/a94j7n/EBWBiVnaMgPkoZDkyL6+hIlKhRE8txPajxp+\n Y9M0iTcMNtyCu6/jIdyLm4jcgMLY9H5dbMAmxXWspX6w0DwkYjPfydp0gbvXcHsZn4gDOGImSV6\n GabaWdzg+KnUCTw5HixG8/n9Z2JGM1XOI7cJYVVdBtS18o8W/pfijNBjmpnEOnXfZtltz8FREj8\n bLtiY1SnjNytolW+N4CjecU0EtdmvLVptl/dsVAzyi08aqbr2dakYaSaawfgPZXgW+5KsT/SM7N\n 4AuPkHx6GG82GuqztxA==",
        "X-Authority-Analysis": "v=2.4 cv=QKZlhwLL c=1 sm=1 tr=0 ts=69ced306 cx=c_pps\n a=5BHTudwdYE3Te8bg5FgnPg==:117 a=5BHTudwdYE3Te8bg5FgnPg==:17\n a=IkcTkHD0fZMA:10 a=A5OVakUREuEA:10 a=VkNPw1HP01LnGYTKEx00:22\n a=RnoormkPH1_aCDwRdu11:22 a=Y2IxJ9c9Rs8Kov3niI8_:22 a=VnNF1IyMAAAA:8\n a=WU3I-MCEZjdC1qMpAq0A:9 a=QEXdDO2ut3YA:10",
        "X-Proofpoint-GUID": "NPCAGVnw9idcZ97Ujhgns4OWUFp07P68",
        "X-Proofpoint-ORIG-GUID": "IiZkK2NLY_GhNficRY4jtlQg7oLkHWye",
        "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49\n definitions=2026-04-02_03,2026-04-02_05,2025-10-01_01",
        "X-Proofpoint-Spam-Details": "rule=outbound_notspam policy=outbound score=0\n lowpriorityscore=0 phishscore=0 adultscore=0 impostorscore=0 clxscore=1015\n spamscore=0 bulkscore=0 priorityscore=1501 suspectscore=0 malwarescore=0\n classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0\n reason=mlx scancount=1 engine=8.22.0-2603050001 definitions=main-2604020181"
    },
    "content": "On s390, an individual PCI function can generally be identified by two\nidentifiers, the FID and the UID. Which identifier is used depends on\nthe scope and the platform configuration.\n\nThe first identifier, the FID, is always available and identifies a PCI\ndevice uniquely within a machine. The FID may be virtualized by\nhypervisors, but on the LPAR level, the machine scope makes it\nimpossible to create the same configuration based on FIDs on two\ndifferent LPARs of the same machine, and difficult to reuse across\nmachines.\n\nSuch matching LPAR configurations are useful, though, allowing\nstandardized setups and booting a Linux installation on different LPARs.\nTo this end the UID, or user-defined identifier, was introduced. While\nit is only guaranteed to be unique within an LPAR and only if indicated\nby firmware, it allows users to replicate PCI device setups.\n\nOn s390, which uses a machine hypervisor, a per PCI function hotplug\nmodel is used. The shortcoming with the UID then is, that it is not\nvisible to the user without first attaching the PCI function and\naccessing the \"uid\" device attribute. The FID, on the other hand, is\nused as the slot name and is thus known even with the PCI function in\nstandby.\n\nRemedy this shortcoming by providing the UID as an attribute on the slot\nallowing the user to identify a PCI function based on the UID without\nhaving to first attach it. Do this via a macro mechanism analogous to\nwhat was introduced by commit 265baca69a07 (\"s390/pci: Stop usurping\npdev->dev.groups\") for the PCI device attributes.\n\nReviewed-by: Gerd Bayer <gbayer@linux.ibm.com>\nReviewed-by: Julian Ruess <julianr@linux.ibm.com>\nSigned-off-by: Niklas Schnelle <schnelle@linux.ibm.com>\n---\n Documentation/arch/s390/pci.rst |  7 +++++++\n arch/s390/include/asm/pci.h     |  4 ++++\n arch/s390/pci/pci_sysfs.c       | 20 ++++++++++++++++++++\n drivers/pci/slot.c              | 13 ++++++++++++-\n 4 files changed, 43 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/Documentation/arch/s390/pci.rst b/Documentation/arch/s390/pci.rst\nindex 31c24ed5506f1fc07f89821f67a814118514f441..4c0f35c8a5588eee3cf0d596e0057f24b3ed079c 100644\n--- a/Documentation/arch/s390/pci.rst\n+++ b/Documentation/arch/s390/pci.rst\n@@ -57,6 +57,13 @@ Entries specific to zPCI functions and entries that hold zPCI information.\n \n   - /sys/bus/pci/slots/XXXXXXXX/power\n \n+  In addition to using the FID as the name of the slot the slot directory\n+  also contains the following s390 specific slot attributes.\n+\n+  - uid:\n+    The User-defined identifier (UID) of the function which may be configured\n+    by this slot. See also the corresponding attribute of the device.\n+\n   A physical function that currently supports a virtual function cannot be\n   powered off until all virtual functions are removed with:\n   echo 0 > /sys/bus/pci/devices/DDDD:BB:dd.f/sriov_numvf\ndiff --git a/arch/s390/include/asm/pci.h b/arch/s390/include/asm/pci.h\nindex c0ff19dab5807c7e1aabb48a0e9436aac45ec97d..5dcf35f0f325f5f44b28109a1c8d9aef18401035 100644\n--- a/arch/s390/include/asm/pci.h\n+++ b/arch/s390/include/asm/pci.h\n@@ -208,6 +208,10 @@ extern const struct attribute_group zpci_ident_attr_group;\n \t\t\t    &pfip_attr_group,\t\t \\\n \t\t\t    &zpci_ident_attr_group,\n \n+extern const struct attribute_group zpci_slot_attr_group;\n+\n+#define ARCH_PCI_SLOT_GROUPS (&zpci_slot_attr_group)\n+\n extern unsigned int s390_pci_force_floating __initdata;\n extern unsigned int s390_pci_no_rid;\n \ndiff --git a/arch/s390/pci/pci_sysfs.c b/arch/s390/pci/pci_sysfs.c\nindex c2444a23e26c4218832bb91930b5f0ffd498d28f..d98d97df792adb3c7e415a8d374cc2f3a65fbb52 100644\n--- a/arch/s390/pci/pci_sysfs.c\n+++ b/arch/s390/pci/pci_sysfs.c\n@@ -187,6 +187,17 @@ static ssize_t index_show(struct device *dev,\n }\n static DEVICE_ATTR_RO(index);\n \n+static ssize_t zpci_uid_slot_show(struct pci_slot *slot, char *buf)\n+{\n+\tstruct zpci_dev *zdev = container_of(slot->hotplug, struct zpci_dev,\n+\t\t\t\t\t     hotplug_slot);\n+\n+\treturn sysfs_emit(buf, \"0x%x\\n\", zdev->uid);\n+}\n+\n+static struct pci_slot_attribute zpci_slot_attr_uid =\n+\t__ATTR(uid, 0444, zpci_uid_slot_show, NULL);\n+\n static umode_t zpci_index_is_visible(struct kobject *kobj,\n \t\t\t\t     struct attribute *attr, int n)\n {\n@@ -243,6 +254,15 @@ const struct attribute_group pfip_attr_group = {\n \t.attrs = pfip_attrs,\n };\n \n+static struct attribute *zpci_slot_attrs[] = {\n+\t&zpci_slot_attr_uid.attr,\n+\tNULL,\n+};\n+\n+const struct attribute_group zpci_slot_attr_group = {\n+\t.attrs = zpci_slot_attrs,\n+};\n+\n static struct attribute *clp_fw_attrs[] = {\n \t&uid_checking_attr.attr,\n \tNULL,\ndiff --git a/drivers/pci/slot.c b/drivers/pci/slot.c\nindex 787311614e5b6ebb39e7284f9b9f205a0a684d6d..2f8fcfbbec24e73d0bb6e40fd04c05a94f518045 100644\n--- a/drivers/pci/slot.c\n+++ b/drivers/pci/slot.c\n@@ -96,7 +96,18 @@ static struct attribute *pci_slot_default_attrs[] = {\n \t&pci_slot_attr_cur_speed.attr,\n \tNULL,\n };\n-ATTRIBUTE_GROUPS(pci_slot_default);\n+\n+static const struct attribute_group pci_slot_default_group = {\n+\t.attrs = pci_slot_default_attrs,\n+};\n+\n+static const struct attribute_group *pci_slot_default_groups[] = {\n+\t&pci_slot_default_group,\n+#ifdef ARCH_PCI_SLOT_GROUPS\n+\tARCH_PCI_SLOT_GROUPS,\n+#endif\n+\tNULL,\n+};\n \n static const struct kobj_type pci_slot_ktype = {\n \t.sysfs_ops = &pci_slot_sysfs_ops,\n",
    "prefixes": [
        "v6",
        "2/2"
    ]
}