命令格式
dpdk-devbind.py是一个工具,命令使用格式如下:
dpdk-devbind.py [options] DEVICE1 DEVICE2 ....
其中,
- DEVICE1、DEVICE2等表示使用PCI号(可以是domain:bus:slot.func或者bus:slot.func格式)来标识的设备;对于绑定到Linux内核驱动的设备,也可以使用Linux接口的名字来标识该设备,例如eth0、eth1等等。
- options为可选参数,可以取值:
- --help, --usage:显示提示信息
- -s, --status:打印当前已知的network、crypto、event、mempool设备的状态。
- --status-dev dev_grp:打印给定设备组的状态,支持的组有:net、crypto、event、mempool、compress。
- -b drvier, --bind=driver:选择将设备绑定到该驱动,设为none时表示解绑。
- -u, --unbind:解绑设备,等价于 -b none。
- --force:允许将active的设备进行强制解绑。
举例
查询设备信息
# ./usertools/dpdk-devbind.py --status
Network devices using kernel driver
===================================
0000:00:03.0 'Virtio network device 1000' if=eth0 drv=virtio-pci unused=virtio_pci,igb_uio *Active*
0000:00:07.0 'Virtio network device 1000' if=eth1 drv=virtio-pci unused=virtio_pci,igb_uio *Active*
No 'Crypto' devices detected
============================
No 'Eventdev' devices detected
==============================
No 'Mempool' devices detected
=============================
No 'Compress' devices detected
==============================
从输出的信息来看我的主机上有两个网络设备,目前使用的都是内核驱动virtio-pci,都是Active状态,未使用的驱动是的igb_uio,这是dpdk的一款驱动,下面我们就要把其中一个设备绑定到该驱动上。
注:其他的crypto、eventdev等设备我的主机上找不到,下面的例子将省略这些设备信息的显示,使用命令
./usertools/dpdk-devbind.py --status-dev net
来显示网络设备的信息。
绑定设备
# ./usertools/dpdk-devbind.py --bind=igb_uio 0000:00:07.0
Routing table indicates that interface 0000:00:07.0 is active. Not modifying
# ./usertools/dpdk-devbind.py --force --bind=igb_uio 0000:00:07.0
# ./usertools/dpdk-devbind.py --status-dev net
Network devices using DPDK-compatible driver
============================================
0000:00:07.0 'Virtio network device 1000' drv=igb_uio unused=virtio_pci
Network devices using kernel driver
===================================
0000:00:03.0 'Virtio network device 1000' if=eth0 drv=virtio-pci unused=virtio_pci,igb_uio *Active*
第一条我使用命令将PCI为0000:00:07.0的设备绑定到igb_uio的dpdk驱动上,显示该设备是active,不允许修改;第二条命令加了一个--force之后成功绑定;第三条命令显示当前设备的状态,可以看到有一个DPDK兼容的驱动设备,还有一个内核驱动的设备。
注:绑定时一定要避免正在使用ssh登陆的网卡,否则绑定之后网络将会中断,只能重启主机来恢复环境了。
解绑设备
# ./usertools/dpdk-devbind.py -u 0000:00:07.0
# ./usertools/dpdk-devbind.py --status-dev net
Network devices using kernel driver
===================================
0000:00:03.0 'Virtio network device 1000' if=eth0 drv=virtio-pci unused=virtio_pci,igb_uio *Active*
Other Network devices
=====================
0000:00:07.0 'Virtio network device 1000' unused=virtio_pci,igb_uio
# ./usertools/dpdk-devbind.py --bind=virtio-pci 0000:00:07.0
# ./usertools/dpdk-devbind.py --status-dev net
Network devices using kernel driver
===================================
0000:00:03.0 'Virtio network device 1000' if=eth0 drv=virtio-pci unused=virtio_pci,igb_uio *Active*
0000:00:07.0 'Virtio network device 1000' if=eth1 drv=virtio-pci unused=virtio_pci,igb_uio
第一条命令将igb_uio驱动的设备进行解绑,第二条命令查看状态可以看到该设备当前没有绑定到任何驱动上,第三条命令将该设备绑回virtio-pci的内核驱动,第四条命令可以看到已经绑回去。