Documentation/ABI/testing/sysfs-bus-vfio-mdev

Source file repositories/reference/linux-study-clean/Documentation/ABI/testing/sysfs-bus-vfio-mdev

File Facts

System
Linux kernel
Corpus path
Documentation/ABI/testing/sysfs-bus-vfio-mdev
Extension
[no extension]
Size
4563 bytes
Lines
114
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: Documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

What:           /sys/.../<device>/mdev_supported_types/
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
                This directory contains list of directories of currently
		supported mediated device types and their details for
		<device>. Supported type attributes are defined by the
		vendor driver who registers with Mediated device framework.
		Each supported type is a directory whose name is created
		by adding the device driver string as a prefix to the
		string provided by the vendor driver.

What:           /sys/.../<device>/mdev_supported_types/<type-id>/
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
                This directory gives details of supported type, like name,
		description, available_instances, device_api etc.
		'device_api' and 'available_instances' are mandatory
		attributes to be provided by vendor driver. 'name',
		'description' and other vendor driver specific attributes
		are optional.

What:           /sys/.../mdev_supported_types/<type-id>/create
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
		Writing UUID to this file will create mediated device of
		type <type-id> for parent device <device>. This is a
		write-only file.
		For example::

		  # echo "83b8f4f2-509f-382f-3c1e-e6bfe0fa1001" >	\
		       /sys/devices/foo/mdev_supported_types/foo-1/create

What:           /sys/.../mdev_supported_types/<type-id>/devices/
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
		This directory contains symbolic links pointing to mdev
		devices sysfs entries which are created of this <type-id>.

What:           /sys/.../mdev_supported_types/<type-id>/available_instances
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
		Reading this attribute will show the number of mediated
		devices of type <type-id> that can be created. This is a
		readonly file.
Users:
		Userspace applications interested in creating mediated
		device of that type. Userspace application should check
		the number of available instances could be created before
		creating mediated device of this type.

What:           /sys/.../mdev_supported_types/<type-id>/device_api
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
		Reading this attribute will show VFIO device API supported
		by this type. For example, "vfio-pci" for a PCI device,
		"vfio-platform" for platform device.

What:           /sys/.../mdev_supported_types/<type-id>/name
Date:           October 2016
Contact:        Kirti Wankhede <kwankhede@nvidia.com>
Description:
		Reading this attribute will show human readable name of the
		mediated device that will get created of type <type-id>.
		This is optional attribute. For example: "Grid M60-0Q"

Annotation

Implementation Notes