docs: document sysfs ABI for vDPA bus
authorStefano Garzarella <sgarzare@redhat.com>
Fri, 26 Nov 2021 16:47:52 +0000 (17:47 +0100)
committerMichael S. Tsirkin <mst@redhat.com>
Fri, 14 Jan 2022 23:50:52 +0000 (18:50 -0500)
Add missing documentation of sysfs ABI for vDPA bus in
the new Documentation/ABI/testing/sysfs-bus-vdpa file.

Signed-off-by: Stefano Garzarella <sgarzare@redhat.com>
Link: https://lore.kernel.org/r/20211126164753.181829-2-sgarzare@redhat.com
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
Acked-by: Jason Wang <jasowang@redhat.com>
Documentation/ABI/testing/sysfs-bus-vdpa [new file with mode: 0644]
MAINTAINERS

diff --git a/Documentation/ABI/testing/sysfs-bus-vdpa b/Documentation/ABI/testing/sysfs-bus-vdpa
new file mode 100644 (file)
index 0000000..4e55761
--- /dev/null
@@ -0,0 +1,37 @@
+What:          /sys/bus/vdpa/driver_autoprobe
+Date:          March 2020
+Contact:       virtualization@lists.linux-foundation.org
+Description:
+               This file determines whether new devices are immediately bound
+               to a driver after the creation. It initially contains 1, which
+               means the kernel automatically binds devices to a compatible
+               driver immediately after they are created.
+
+               Writing "0" to this file disable this feature, any other string
+               enable it.
+
+What:          /sys/bus/vdpa/driver_probe
+Date:          March 2020
+Contact:       virtualization@lists.linux-foundation.org
+Description:
+               Writing a device name to this file will cause the kernel binds
+               devices to a compatible driver.
+
+               This can be useful when /sys/bus/vdpa/driver_autoprobe is
+               disabled.
+
+What:          /sys/bus/vdpa/drivers/.../bind
+Date:          March 2020
+Contact:       virtualization@lists.linux-foundation.org
+Description:
+               Writing a device name to this file will cause the driver to
+               attempt to bind to the device. This is useful for overriding
+               default bindings.
+
+What:          /sys/bus/vdpa/drivers/.../unbind
+Date:          March 2020
+Contact:       virtualization@lists.linux-foundation.org
+Description:
+               Writing a device name to this file will cause the driver to
+               attempt to unbind from the device. This may be useful when
+               overriding default bindings.
index fb18ce7..d10667b 100644 (file)
@@ -20132,6 +20132,7 @@ M:      "Michael S. Tsirkin" <mst@redhat.com>
 M:     Jason Wang <jasowang@redhat.com>
 L:     virtualization@lists.linux-foundation.org
 S:     Maintained
+F:     Documentation/ABI/testing/sysfs-bus-vdpa
 F:     Documentation/devicetree/bindings/virtio/
 F:     drivers/block/virtio_blk.c
 F:     drivers/crypto/virtio/