linux/Documentation/s390
Niklas Schnelle 408f2c9c15 s390/pci: expose UID uniqueness guarantee
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 ac4995b9d5
("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: Niklas Schnelle <schnelle@linux.ibm.com>
Reviewed-by: Viktor Mihajlovski <mihajlov@linux.ibm.com>
Signed-off-by: Heiko Carstens <hca@linux.ibm.com>
2021-04-05 11:30:57 +02:00
..
3270.ChangeLog Documentation: Use "while" instead of "whilst" 2018-11-20 09:30:43 -07:00
3270.rst docs: s390: convert docs to ReST and rename to *.rst 2019-06-11 09:48:14 +02:00
cds.rst docs: s390: convert docs to ReST and rename to *.rst 2019-06-11 09:48:14 +02:00
common_io.rst docs: s390: convert docs to ReST and rename to *.rst 2019-06-11 09:48:14 +02:00
config3270.sh
driver-model.rst docs: s390: convert docs to ReST and rename to *.rst 2019-06-11 09:48:14 +02:00
features.rst docs: archis: add a per-architecture features list 2020-12-03 15:10:15 -07:00
index.rst docs: archis: add a per-architecture features list 2020-12-03 15:10:15 -07:00
monreader.rst S390: Replace HTTP links with HTTPS ones 2020-07-13 11:33:14 -06:00
pci.rst s390/pci: expose UID uniqueness guarantee 2021-04-05 11:30:57 +02:00
qeth.rst docs: s390: convert docs to ReST and rename to *.rst 2019-06-11 09:48:14 +02:00
s390dbf.rst s390/debug: remove raw view 2020-06-29 16:32:20 +02:00
text_files.rst docs: s390: convert docs to ReST and rename to *.rst 2019-06-11 09:48:14 +02:00
vfio-ap.rst Documentation: s390/vfio-ap: eliminate duplicated word 2020-07-13 09:44:07 -06:00
vfio-ccw.rst vfio-ccw: Introduce a new CRW region 2020-06-03 11:27:43 +02:00
zfcpdump.rst Documentation/s390: Update / remove developerWorks web links 2020-05-20 10:22:51 +02:00