Re: [PATCH v4] vfio: Add property documentation

[Eric Farman <farman@linux.ibm.com>]

On Mon, 2025-02-17 at 18:34 +0100, Cédric Le Goater wrote:
> Investigate the git history to uncover when and why the VFIO
> properties were introduced and update the models. This is mostly
> targeting vfio-pci device, since vfio-platform, vfio-ap and vfio-ccw
> devices are simpler.
> 
> Sort the properties based on the QEMU version in which they were
> introduced.
> 
> Cc: Tony Krowiak <akrowiak@linux.ibm.com>
> Cc: Eric Farman <farman@linux.ibm.com>
> Cc: Eric Auger <eric.auger@redhat.com>
> Signed-off-by: Cédric Le Goater <clg@redhat.com>
> ---
> 
>  Should we introduce documentation for properties like the kernel has
>  in Documentation/ABI/*/sysfs-* ?
> 
>  Changes in v4:
> 
>  - Latest improvements from Alex 
> 
>  Changes in v3:
> 
>  - Re-organized the vfio-pci properties based on the QEMU version in
>    which they were introduced
>  - Added property labels
>  - Improved description as suggested by Alex, Tomita and Corvin
> 
>  Changes in v2:
> 
>  - Fixed version numbers
>  - Fixed #ifdef in vfio/ccw.c
>  - Addressed vfio-pci-nohotplug
>  - Organize the vfio-pci properties in topics
> 
>  hw/vfio/ap.c       |   9 ++++
>  hw/vfio/ccw.c      |  15 ++++++
>  hw/vfio/pci.c      | 125 +++++++++++++++++++++++++++++++++++++++++++++
>  hw/vfio/platform.c |  24 +++++++++
>  4 files changed, 173 insertions(+)

Reviewed-by: Eric Farman <farman@linux.ibm.com> # vfio-ccw