xref: /linux/Documentation/ABI/testing/sysfs-driver-pciback (revision cdd38c5f1ce4398ec58fec95904b75824daab7b5)
18b63c998SKonrad Rzeszutek WilkWhat:           /sys/bus/pci/drivers/pciback/quirks
28b63c998SKonrad Rzeszutek WilkDate:           Oct 2011
38b63c998SKonrad Rzeszutek WilkKernelVersion:  3.1
48b63c998SKonrad Rzeszutek WilkContact:        xen-devel@lists.xenproject.org
58b63c998SKonrad Rzeszutek WilkDescription:
68b63c998SKonrad Rzeszutek Wilk                If the permissive attribute is set, then writing a string in
78b63c998SKonrad Rzeszutek Wilk                the format of DDDD:BB:DD.F-REG:SIZE:MASK will allow the guest
88b63c998SKonrad Rzeszutek Wilk                to write and read from the PCI device. That is Domain:Bus:
98b63c998SKonrad Rzeszutek Wilk                Device.Function-Register:Size:Mask (Domain is optional).
10*54a19b4dSMauro Carvalho Chehab                For example::
11*54a19b4dSMauro Carvalho Chehab
128b63c998SKonrad Rzeszutek Wilk                  #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
13*54a19b4dSMauro Carvalho Chehab
148b63c998SKonrad Rzeszutek Wilk                will allow the guest to read and write to the configuration
158b63c998SKonrad Rzeszutek Wilk                register 0x0E.
16476878e4SMarek Marczykowski-Górecki
17476878e4SMarek Marczykowski-GóreckiWhat:           /sys/bus/pci/drivers/pciback/allow_interrupt_control
18476878e4SMarek Marczykowski-GóreckiDate:           Jan 2020
19476878e4SMarek Marczykowski-GóreckiKernelVersion:  5.6
20476878e4SMarek Marczykowski-GóreckiContact:        xen-devel@lists.xenproject.org
21476878e4SMarek Marczykowski-GóreckiDescription:
22476878e4SMarek Marczykowski-Górecki                List of devices which can have interrupt control flag (INTx,
23476878e4SMarek Marczykowski-Górecki                MSI, MSI-X) set by a connected guest. It is meant to be set
24476878e4SMarek Marczykowski-Górecki                only when the guest is a stubdomain hosting device model (qemu)
25476878e4SMarek Marczykowski-Górecki                and the actual device is assigned to a HVM. It is not safe
26476878e4SMarek Marczykowski-Górecki                (similar to permissive attribute) to set for a devices assigned
27476878e4SMarek Marczykowski-Górecki                to a PV guest. The device is automatically removed from this
28476878e4SMarek Marczykowski-Górecki                list when the connected pcifront terminates.
29