Update vfio/mdev ABI description for new aggregation attributes. Cc: Kirti Wankhede <kwankhede@xxxxxxxxxx> Cc: Alex Williamson <alex.williamson@xxxxxxxxxx> Cc: Kevin Tian <kevin.tian@xxxxxxxxx> Cc: Cornelia Huck <cohuck@xxxxxxxxxx> Signed-off-by: Zhenyu Wang <zhenyuw@xxxxxxxxxxxxxxx> --- Documentation/ABI/testing/sysfs-bus-vfio-mdev | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-bus-vfio-mdev b/Documentation/ABI/testing/sysfs-bus-vfio-mdev index 452dbe39270e..6645ff9a6a6a 100644 --- a/Documentation/ABI/testing/sysfs-bus-vfio-mdev +++ b/Documentation/ABI/testing/sysfs-bus-vfio-mdev @@ -85,6 +85,23 @@ Users: a particular <type-id> that can help in understanding the features provided by that type of mediated device. +What: /sys/.../mdev_supported_types/<type-id>/aggregation +Date: October 2019 +Contact: Zhenyu Wang <zhenyuw@xxxxxxxxxxxxxxx> +Description: + Reading this attribute will show number of mdev instances + that can be aggregated to assign for one mdev device. + This is an optional attribute. If this attribute exists, + the driver supports to aggregate target mdev type's + resources assigned for one mdev device. +Users: + Userspace application should check the number of aggregation + instances that could be created before creating mediated device. + Create mdev instance with aggregation by applying this, + e.g + # echo "83b8f4f2-509f-382f-3c1e-e6bfe0fa1001,aggregate=XX" > \ + /sys/devices/foo/mdev_supported_types/foo-1/create + What: /sys/.../<device>/<UUID>/ Date: October 2016 Contact: Kirti Wankhede <kwankhede@xxxxxxxxxx> @@ -109,3 +126,10 @@ Description: is active and the vendor driver doesn't support hot unplug. Example: # echo 1 > /sys/bus/mdev/devices/<UUID>/remove + +What: /sys/.../<device>/<UUID>/aggregated_instances +Date: October 2019 +Contact: Zhenyu Wang <zhenyuw@xxxxxxxxxxxxxxx> +Description: + This attributes shows number of aggregated instances if this + mediated device was created with "aggregate" parameter. \ No newline at end of file -- 2.24.0.rc0
