table of contents
DPDK-DEVBIND(8) | Data Plane Development Kit | DPDK-DEVBIND(8) |
NAME¶
dpdk-devbind - check device status and bind/unbind them from drivers
The dpdk-devbind tool is a Data Plane Development Kit (DPDK) utility that helps binding and unbinding devices from specific drivers. As well as checking their status in that regard.
RUNNING THE APPLICATION¶
The tool has a number of command line options:
dpdk-devbind [options] DEVICE1 DEVICE2 ....
OPTIONS¶
- •
- --help, --usage
- •
- -s, --status
- •
- -b driver, --bind=driver
- •
- -u, --unbind
- •
- --force
WARNING:
If your device is behind a PCI-to-PCI bridge, the bridge will then be part of the IOMMU group in which your device is in. Therefore, the bridge driver should also be unbound from the bridge PCI device for VFIO to work with devices behind the bridge.
WARNING:
EXAMPLES¶
To display current device status:
dpdk-devbind --status
To bind eth1 from the current driver and move to use igb_uio:
dpdk-devbind --bind=igb_uio eth1
To unbind 0000:01:00.0 from using any driver:
dpdk-devbind -u 0000:01:00.0
To bind 0000:02:00.0 and 0000:02:00.1 to the ixgbe kernel driver:
dpdk-devbind -b ixgbe 02:00.0 02:00.1
To check status of all network ports, assign one to the igb_uio driver and check status again:
# Check the status of the available devices. dpdk-devbind --status Network devices using DPDK-compatible driver ============================================ <none> Network devices using kernel driver =================================== 0000:0a:00.0 '82599ES 10-Gigabit' if=eth2 drv=ixgbe unused= # Bind the device to igb_uio. sudo dpdk-devbind -b igb_uio 0000:0a:00.0 # Recheck the status of the devices. dpdk-devbind --status Network devices using DPDK-compatible driver ============================================ 0000:0a:00.0 '82599ES 10-Gigabit' drv=igb_uio unused=
August 27, 2018 | 18.08.0 |