[libvirt] [PATCH v3 5/6] Documentation/ABI/testing/sysfs-bus-vfio-mdev: Update for vfio/mdev aggregation support
Update vfio/mdev ABI description for new aggregation attributes.
Cc: Kirti Wankhede <kwankhede(a)nvidia.com>
Cc: Alex Williamson <alex.williamson(a)redhat.com>
Cc: Kevin Tian <kevin.tian(a)intel.com>
Cc: Cornelia Huck <cohuck(a)redhat.com>
Signed-off-by: Zhenyu Wang <zhenyuw(a)linux.intel.com>
---
Documentation/ABI/testing/sysfs-bus-vfio-mdev | 25 +++++++++++++++++++
1 file changed, 25 insertions(+)
diff --git a/Documentation/ABI/testing/sysfs-bus-vfio-mdev
b/Documentation/ABI/testing/sysfs-bus-vfio-mdev
index 452dbe39270e..192fe06e60d0 100644
--- a/Documentation/ABI/testing/sysfs-bus-vfio-mdev
+++ b/Documentation/ABI/testing/sysfs-bus-vfio-mdev
@@ -85,6 +85,24 @@ 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 2018
+Contact: Zhenyu Wang <zhenyuw(a)linux.intel.com>
+Description:
+ Reading this attribute will show number of mdev instances
+ that can be aggregated to assign for one mdev device.
+ This is optional attribute. If this attribute exists that
+ means driver supports to aggregate target mdev type's
+ resources assigned for one mdev device.
+Users:
+ Userspace applications interested in creating mediated
+ device with aggregated type instances. Userspace application
+ should check the number of aggregation instances that could
+ be created before creating mediated device 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(a)nvidia.com>
@@ -109,3 +127,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 2018
+Contact: Zhenyu Wang <zhenyuw(a)linux.intel.com>
+Description:
+ This attributes shows number of aggregated instances if this
+ mediated device was created with "aggregate" parameter.
\ No newline at end of file
--
2.19.1