[PATCH v2 1/2] docs: document sysfs ABI for vDPA bus

From: Stefano Garzarella
Date: Fri Nov 26 2021 - 11:50:10 EST


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@xxxxxxxxxx>
---
Documentation/ABI/testing/sysfs-bus-vdpa | 37 ++++++++++++++++++++++++
MAINTAINERS | 1 +
2 files changed, 38 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-bus-vdpa

diff --git a/Documentation/ABI/testing/sysfs-bus-vdpa b/Documentation/ABI/testing/sysfs-bus-vdpa
new file mode 100644
index 000000000000..4e55761a39df
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-vdpa
@@ -0,0 +1,37 @@
+What: /sys/bus/vdpa/driver_autoprobe
+Date: March 2020
+Contact: virtualization@xxxxxxxxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxxxxxxxx
+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.
diff --git a/MAINTAINERS b/MAINTAINERS
index 5250298d2817..36ea80b4ba63 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -20104,6 +20104,7 @@ M: "Michael S. Tsirkin" <mst@xxxxxxxxxx>
M: Jason Wang <jasowang@xxxxxxxxxx>
L: virtualization@xxxxxxxxxxxxxxxxxxxxxxxxxx
S: Maintained
+F: Documentation/ABI/testing/sysfs-bus-vdpa
F: Documentation/devicetree/bindings/virtio/
F: drivers/block/virtio_blk.c
F: drivers/crypto/virtio/
--
2.31.1