|driverctl(8)||System Manager's Manual||driverctl(8)|
NAME¶driverctl - Device driver control utility.
SYNOPSIS¶driverctl [OPTIONS] COMMAND [DEVICE [DRIVER]]
DESCRIPTION¶driverctl may be used to manipulate and inspect the system device driver choices.
Devices are normally assigned to their sole designated kernel driver by default. However in some situations it may be desireable to override that default, for example to try an older driver to work around a regression in a driver or to try an experimental alternative driver. Another common use-case is pass-through drivers and driver stubs to allow userspace to drive the device, such as in case of virtualization.
driverctl integrates with udev to support overriding driver selection for both cold- and hotplugged devices from the moment of discovery, but can also change already assigned drivers, assuming they are not in use by the system. The driver overrides created by driverctl are persistent across system reboots by default.
OPTIONS¶The following options are understood:
COMMANDS¶The following commands are understood:
set-override <DEVICE> <DRIVER>
As a special case, specifying "none" as the driver will prevent any driver to be bound to the device until the override is removed.
EXIT STATUS¶On success, 0 is returned, a non-zero failure code otherwise.
Find devices currently driven by ixgbe driver: # driverctl -v list-devices | grep ixgbe 0000:01:00.0 ixgbe (Ethernet 10G 4P X520/I350 rNDC) 0000:01:00.1 ixgbe (Ethernet 10G 4P X520/I350 rNDC) Change them to use the vfio-pci driver: # driverctl set-override 0000:01:00.0 vfio-pci # driverctl set-override 0000:01:00.1 vfio-pci Find devices with driver overrides: # driverctl -v list-overrides 0000:01:00.0 vfio-pci (Ethernet 10G 4P X520/I350 rNDC) 0000:01:00.1 vfio-pci (Ethernet 10G 4P X520/I350 rNDC) Find network devices: # driverctl list-devices network 0000:01:00.0 ixgbe 0000:01:00.1 ixgbe 0000:06:00.0 igb 0000:06:00.1 igb Remove the override from slot 0000:01:00.1: # driverctl unset-override 0000:01:00.1