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

[Jason Wang]

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
>