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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <CACGkMEuEONMW3wvPULbL+9U0UkJ43zaq8__FySeZC7J4-ZPb7w@mail.gmail.com>
Date:   Mon, 29 Nov 2021 11:10:38 +0800
From:   Jason Wang <jasowang@...hat.com>
To:     Stefano Garzarella <sgarzare@...hat.com>
Cc:     virtualization <virtualization@...ts.linux-foundation.org>,
        linux-kernel <linux-kernel@...r.kernel.org>,
        "Michael S. Tsirkin" <mst@...hat.com>,
        Parav Pandit <parav@...dia.com>
Subject: Re: [PATCH v2 1/2] docs: document sysfs ABI for vDPA bus

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

Acked-by: Jason Wang <jasowang@...hat.com>

> ---
>  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@...ts.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@...ts.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@...ts.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@...ts.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.
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 5250298d2817..36ea80b4ba63 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -20104,6 +20104,7 @@ M:      "Michael S. Tsirkin" <mst@...hat.com>
>  M:     Jason Wang <jasowang@...hat.com>
>  L:     virtualization@...ts.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/
> --
> 2.31.1
>