• Niklas Schnelle's avatar
    s390/pci: expose UID uniqueness guarantee · 408f2c9c
    Niklas Schnelle authored
    On s390 each PCI device has a user-defined ID (UID) exposed under
    /sys/bus/pci/devices/<dev>/uid. This ID was designed to serve as the PCI
    device's primary index and to match the device within Linux to the
    device configured in the hypervisor. To serve as a primary identifier
    the UID must be unique within the Linux instance, this is guaranteed by
    the platform if and only if the UID Uniqueness Checking flag is set
    within the CLP List PCI Functions response.
    
    While the UID has been exposed to userspace since commit ac4995b9
    ("s390/pci: add some new arch specific pci attributes") whether or not
    the platform guarantees its uniqueness for the lifetime of the Linux
    instance while defined is not visible from userspace. Remedy this by
    exposing this as a per device attribute at
    
    /sys/bus/pci/devices/<dev>/uid_is_unique
    
    Keeping this a per device attribute allows for maximum flexibility if we
    ever end up with some devices not having a UID or not enjoying the
    guaranteed uniqueness.
    Signed-off-by: default avatarNiklas Schnelle <schnelle@linux.ibm.com>
    Reviewed-by: default avatarViktor Mihajlovski <mihajlov@linux.ibm.com>
    Signed-off-by: default avatarHeiko Carstens <hca@linux.ibm.com>
    408f2c9c
pci.rst 3.93 KB