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

From: Jason Wang
Date: Sun Nov 28 2021 - 22:12:56 EST


On Sat, Nov 27, 2021 at 12:48 AM Stefano Garzarella <sgarzare@xxxxxxxxxx> wrote:
>
> 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>

Acked-by: Jason Wang <jasowang@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
>