xref: /linux/Documentation/ABI/testing/sysfs-bus-vdpa (revision 79790b6818e96c58fe2bffee1b418c16e64e7b80)
1fbe29938SShawn.ShaoWhat:		/sys/bus/vdpa/drivers_autoprobe
29c25cdebSStefano GarzarellaDate:		March 2020
3*27103dddSKonstantin RyabitsevContact:	virtualization@lists.linux.dev
49c25cdebSStefano GarzarellaDescription:
59c25cdebSStefano Garzarella		This file determines whether new devices are immediately bound
69c25cdebSStefano Garzarella		to a driver after the creation. It initially contains 1, which
79c25cdebSStefano Garzarella		means the kernel automatically binds devices to a compatible
89c25cdebSStefano Garzarella		driver immediately after they are created.
99c25cdebSStefano Garzarella
109c25cdebSStefano Garzarella		Writing "0" to this file disable this feature, any other string
119c25cdebSStefano Garzarella		enable it.
129c25cdebSStefano Garzarella
139c25cdebSStefano GarzarellaWhat:		/sys/bus/vdpa/driver_probe
149c25cdebSStefano GarzarellaDate:		March 2020
15*27103dddSKonstantin RyabitsevContact:	virtualization@lists.linux.dev
169c25cdebSStefano GarzarellaDescription:
179c25cdebSStefano Garzarella		Writing a device name to this file will cause the kernel binds
189c25cdebSStefano Garzarella		devices to a compatible driver.
199c25cdebSStefano Garzarella
20fbe29938SShawn.Shao		This can be useful when /sys/bus/vdpa/drivers_autoprobe is
219c25cdebSStefano Garzarella		disabled.
229c25cdebSStefano Garzarella
239c25cdebSStefano GarzarellaWhat:		/sys/bus/vdpa/drivers/.../bind
249c25cdebSStefano GarzarellaDate:		March 2020
25*27103dddSKonstantin RyabitsevContact:	virtualization@lists.linux.dev
269c25cdebSStefano GarzarellaDescription:
279c25cdebSStefano Garzarella		Writing a device name to this file will cause the driver to
289c25cdebSStefano Garzarella		attempt to bind to the device. This is useful for overriding
299c25cdebSStefano Garzarella		default bindings.
309c25cdebSStefano Garzarella
319c25cdebSStefano GarzarellaWhat:		/sys/bus/vdpa/drivers/.../unbind
329c25cdebSStefano GarzarellaDate:		March 2020
33*27103dddSKonstantin RyabitsevContact:	virtualization@lists.linux.dev
349c25cdebSStefano GarzarellaDescription:
359c25cdebSStefano Garzarella		Writing a device name to this file will cause the driver to
369c25cdebSStefano Garzarella		attempt to unbind from the device. This may be useful when
379c25cdebSStefano Garzarella		overriding default bindings.
38539fec78SStefano Garzarella
39539fec78SStefano GarzarellaWhat:		/sys/bus/vdpa/devices/.../driver_override
40539fec78SStefano GarzarellaDate:		November 2021
41*27103dddSKonstantin RyabitsevContact:	virtualization@lists.linux.dev
42539fec78SStefano GarzarellaDescription:
43539fec78SStefano Garzarella		This file allows the driver for a device to be specified.
44539fec78SStefano Garzarella		When specified, only a driver with a name matching the value
45539fec78SStefano Garzarella		written to driver_override will have an opportunity to bind to
46539fec78SStefano Garzarella		the device. The override is specified by writing a string to the
47539fec78SStefano Garzarella		driver_override file (echo vhost-vdpa > driver_override) and may
48539fec78SStefano Garzarella		be cleared with an empty string (echo > driver_override).
49539fec78SStefano Garzarella		This returns the device to standard matching rules binding.
50539fec78SStefano Garzarella		Writing to driver_override does not automatically unbind the
51539fec78SStefano Garzarella		device from its current driver or make any attempt to
52539fec78SStefano Garzarella		automatically load the specified driver. If no driver with a
53539fec78SStefano Garzarella		matching name is currently loaded in the kernel, the device will
54539fec78SStefano Garzarella		not bind to any driver. This also allows devices to opt-out of
55539fec78SStefano Garzarella		driver binding using a driver_override name such as "none".
56539fec78SStefano Garzarella		Only a single driver may be specified in the override, there is
57539fec78SStefano Garzarella		no support for parsing delimiters.
58