PCI/sysfs: Expose PCIe device serial number
v6 cover PCI/sysfs: Expose PCIe device serial number
Add a single sysfs read-only, admin-only interface for reading PCIe device serial numbers from userspace, using the same hexadecimal 1-byte dashed formatting as lspci serial number capability output:
sudo cat /sys/devices/pci0000:c0/0000:c0:01.1/0000:c1:00.0/0000:c2:1f.0/0000:ef:00.0/serial_number
00-80-ee-00-00-00-41-80If a device doesn't support the serial number capability, the serial_number sysfs attribute will not be visible.
Comparing serial number format to lspci output:
sudo lspci -vvv -s ef:00.0
ef:00.0 Serial Attached SCSI controller: Broadcom / LSI PCIe Switch management endpoint (rev b0)
Subsystem: Broadcom / LSI Device 0144
...
Capabilities: [100 v1] Device Serial Number 00-80-ee-00-00-00-41-80
...This PCIe device sysfs attribute eliminates the need for parsing lspci output (e.g. regexp) for userspace applications that utilize serial numbers.
Matthew Wood (1):
PCI/sysfs: Expose PCIe device serial number
Documentation/ABI/testing/sysfs-bus-pci | 9 +++++++++ drivers/pci/pci-sysfs.c | 27 ++++++++++++++++++++++--- 2 files changed, 33 insertions(+), 3 deletions(-)
Signature · 1 line
2.50.1
PATCH v6 1/1 PCI/sysfs: Expose PCIe device serial number
Add a single sysfs read-only interface for reading PCIe device serial numbers from userspace in a programmatic way. This device attribute uses the same hexadecimal 1-byte dashed formatting as lspci serial number capability output. If a device doesn't support the serial number capability, the serial_number sysfs attribute will not be visible.
--- Documentation/ABI/testing/sysfs-bus-pci | 9 +++++++++ drivers/pci/pci-sysfs.c | 27 ++++++++++++++++++++++--- 2 files changed, 33 insertions(+), 3 deletions(-)
Documentation/ABI/testing/sysfs-bus-pci +9 -0
@@ -612,3 +612,12 @@ Description: # ls doe_features 0001:01 0001:02 doe_discovery + +What: /sys/bus/pci/devices/.../serial_number +Date: October 2025 +Contact: Matthew Wood <[email protected]> +Description: + This is visible only for PCIe devices that support the serial + number extended capability. The file is read only and due to + the possible sensitivity of accessible serial numbers, admin + only.
drivers/pci/pci-sysfs.c +24 -3
@@ -30,6 +30,7 @@#include <linux/msi.h> #include <linux/of.h> #include <linux/aperture.h> +#include <linux/unaligned.h> #include "pci.h" #ifndef ARCH_PCI_DEV_GROUPS
@@ -239,6 +240,22 @@ static ssize_t current_link_width_show(struct device *dev, }static DEVICE_ATTR_RO (current_link_width); +static ssize_t serial_number_show (struct device *dev, +struct device_attribute *attr,char *buf) +{ +struct pci_dev *pci_dev =to_pci_dev (dev); +u64 dsn; +u8 bytes[8 ]; + + dsn =pci_get_dsn (pci_dev); +if (!dsn) +return -EIO ; +put_unaligned_be64 (dsn, bytes); + +return sysfs_emit (buf,"%8phD\n" , bytes); +} +static DEVICE_ATTR_ADMIN_RO (serial_number); +static ssize_t secondary_bus_number_show (struct device *dev,struct device_attribute *attr,char *buf)
@@ -660,6 +677,7 @@ static struct attribute *pcie_dev_attrs[] = { &dev_attr_current_link_width.attr, &dev_attr_max_link_width.attr, &dev_attr_max_link_speed.attr, + &dev_attr_serial_number.attr, NULL, };
@@ -1749,10 +1767,13 @@ static umode_t pcie_dev_attrs_are_visible(struct kobject *kobj,struct device *dev =kobj_to_dev (kobj);struct pci_dev *pdev =to_pci_dev (dev); -if (pci_is_pcie (pdev)) -return a->mode; +if (!pci_is_pcie (pdev)) +return 0 ; -return 0 ; +if (a == &dev_attr_serial_number.attr && !pci_get_dsn (pdev)) +return 0 ; + +return a->mode; }static const struct attribute_group pci_dev_group = {
Signature · 1 line
2.50.1
Quoted 8 lines · On Fri, 18 Jul 2025 12:32:29 -0700 Matthew Wood <[email protected]> wrote:
Add a single sysfs read-only interface for reading PCIe device serial numbers from userspace in a programmatic way. This device attribute uses the same hexadecimal 1-byte dashed formatting as lspci serial number capability output. If a device doesn't support the serial number capability, the
serial_numbersysfs attribute will not be visible.Signed-off-by Matthew Wood <[email protected]>Reviewed-by Mario Limonciello <[email protected]>
Nice. The %8phD that Thomas pointed out was new to me. Very useful!
Quoted 82 lines
--- Documentation/ABI/testing/sysfs-bus-pci | 9 +++++++++ drivers/pci/pci-sysfs.c | 27 ++++++++++++++++++++++--- 2 files changed, 33 insertions(+), 3 deletions(-)Documentation/ABI/testing/sysfs-bus-pci +9
-0@@ -612,3 +612,12 @@ Description: # ls doe_features 0001:01 0001:02 doe_discovery + +What: /sys/bus/pci/devices/.../serial_number +Date: October 2025 +Contact: Matthew Wood <[email protected]> +Description: + This is visible only for PCIe devices that support the serial + number extended capability. The file is read only and due to + the possible sensitivity of accessible serial numbers, admin + only.drivers/pci/pci-sysfs.c +24
-3@@ -30,6 +30,7 @@#include <linux/msi.h> #include <linux/of.h> #include <linux/aperture.h> +#include <linux/unaligned.h> #include "pci.h" #ifndef ARCH_PCI_DEV_GROUPS @@ -239,6 +240,22 @@ static ssize_t current_link_width_show(struct device *dev, }static DEVICE_ATTR_RO (current_link_width); +static ssize_t serial_number_show (struct device *dev, +struct device_attribute *attr,char *buf) +{ +struct pci_dev *pci_dev =to_pci_dev (dev); +u64 dsn; +u8 bytes[8 ]; + + dsn =pci_get_dsn (pci_dev); +if (!dsn) +return -EIO ; +put_unaligned_be64 (dsn, bytes); + +return sysfs_emit (buf,"%8phD\n" , bytes); +} +static DEVICE_ATTR_ADMIN_RO (serial_number); +static ssize_t secondary_bus_number_show (struct device *dev,struct device_attribute *attr,char *buf)@@ -660,6 +677,7 @@ static struct attribute *pcie_dev_attrs[] = { &dev_attr_current_link_width.attr, &dev_attr_max_link_width.attr, &dev_attr_max_link_speed.attr, + &dev_attr_serial_number.attr, NULL, };@@ -1749,10 +1767,13 @@ static umode_t pcie_dev_attrs_are_visible(struct kobject *kobj,struct device *dev =kobj_to_dev (kobj);struct pci_dev *pdev =to_pci_dev (dev); -if (pci_is_pcie (pdev)) -return a->mode; +if (!pci_is_pcie (pdev)) +return 0 ; -return 0 ; +if (a == &dev_attr_serial_number.attr && !pci_get_dsn (pdev)) +return 0 ; + +return a->mode; }static const struct attribute_group pci_dev_group = {
Quoted 8 lines · Matthew Wood
Add a single sysfs read-only interface for reading PCIe device serial numbers from userspace in a programmatic way. This device attribute uses the same hexadecimal 1-byte dashed formatting as lspci serial number capability output. If a device doesn't support the serial number capability, the
serial_numbersysfs attribute will not be visible.Signed-off-by Matthew Wood <[email protected]>Reviewed-by Mario Limonciello <[email protected]>
Quoted 4 lines
--- Documentation/ABI/testing/sysfs-bus-pci | 9 +++++++++ drivers/pci/pci-sysfs.c | 27 ++++++++++++++++++++++--- 2 files changed, 33 insertions(+), 3 deletions(-)
(...)