3. 环境准备与工具链：lspci、ethtool、dpdk-devbind.py、lshw 等诊断工具的使用

在排查 DPDK 网卡绑定失败与驱动兼容性问题时，准确获取硬件信息、当前驱动状态以及设备绑定关系是第一步。本章将系统介绍 Linux 环境下最核心的四个诊断工具：lspci、ethtool、dpdk-devbind.py 和 lshw。掌握这些工具的输出解读与组合使用技巧，能够帮助你在 5 分钟内定位 80% 的常见绑定故障。

3.1 lspci：硬件层的第一道防线

lspci 是 PCIe 设备枚举工具，直接读取内核 PCI 子系统，是判断网卡是否被操作系统识别的最可靠手段。在 DPDK 场景中，我们重点关注网卡的 PCI 地址、设备 ID 和 当前驱动模块。

3.1.1 常用参数与输出解读

典型输出示例：

# lspci -v -s 0000:03:00.0
03:00.0 Ethernet controller: Intel Corporation 82599ES 10-Gigabit SFI/SFP+ Network Connection (rev 01)
        Subsystem: Intel Corporation 82599ES 10-Gigabit SFI/SFP+ Network Connection
        Flags: bus master, fast devsel, latency 0, IRQ 47
        Memory at 91000000 (64-bit, non-prefetchable) [size=512K]
        Expansion ROM at 91080000 [disabled] [size=512K]
        Capabilities: [40] Power Management version 3
        Capabilities: [50] MSI: Enable- Count=1/1 Maskable- 64bit+
        Capabilities: [70] MSI-X: Enable+ Count=64 Masked-
        Kernel driver in use: igb_uio
        Kernel modules: igb_uio, ixgbe, vfio-pci

3.1.2 网卡未识别的常见原因

• PCIe 链路问题： 使用 lspci -vvv | grep -i "LnkSta" 查看链路速度与宽度，例如 Speed 5GT/s, Width x8。如果显示 Speed 2.5GT/s, Width x1 或 Down，说明物理链路异常。
• 设备 ID 不在 DPDK 支持列表： 使用 lspci -n -s 03:00.0 获取 Vendor:Device 号（如 8086:10fb），与 DPDK 源码 drivers/net/ 下的 *.ini 文件比对。
• IOMMU 或 ACS 影响： 在虚拟化环境中，某些 PCIe 设备可能被 IOMMU 分组隔离，导致 DPDK 无法直接操作。

3.2 ethtool：驱动与链路状态诊断

ethtool 是网络接口层的瑞士军刀，在 DPDK 故障排查中主要用于验证 网卡固件版本、驱动信息 和 基本链路状态。注意：当网卡被 DPDK 绑定后，ethtool 可能无法直接操作该接口，此时应通过 PCI 地址对应的内核接口（如 eth0）在解绑前检查。

3.2.1 核心诊断命令

3.2.2 固件版本兼容性检查

某些 DPDK 驱动（如 ice、iavf）对固件版本有严格依赖。使用 ethtool -i eth0 获取 firmware-version 字段后，与 DPDK Release Notes 中的兼容矩阵比对：

# ethtool -i eth0
driver: ice
version: 1.12.1
firmware-version: 4.30 0x8000e5b0 1.3347.0
expansion-rom-version:
bus-info: 0000:18:00.0
supports-statistics: yes
supports-test: yes
supports-eeprom-access: yes
supports-register-dump: yes
supports-priv-flags: yes

如果固件版本低于 DPDK 要求的最小版本，绑定后可能出现 设备初始化失败 或 链路无法 UP 的问题。此时需要联系网卡厂商获取固件升级包。

3.3 dpdk-devbind.py：绑定状态的核心视图

dpdk-devbind.py 是 DPDK 官方提供的设备绑定管理脚本，位于 usertools/ 目录下。它封装了 driverctl 和 sysfs 操作，提供统一的绑定/解绑接口。在故障排查中，-s 参数是最常用的诊断入口。

3.3.1 状态输出解读

# dpdk-devbind.py -s

Network devices using DPDK-compatible driver
============================================
0000:03:00.0 'Ethernet Controller XXV710' drv=vfio-pci unused=ice
0000:03:00.1 'Ethernet Controller XXV710' drv=vfio-pci unused=ice

Network devices using kernel driver
====================================
0000:18:00.0 'Ethernet Connection X722' if=eth0 drv=ice unused=vfio-pci *Active*
0000:18:00.1 'Ethernet Connection X722' if=eth1 drv=ice unused=vfio-pci

Other network devices
=====================


No 'Crypto' or 'Eventdev' devices found
No 'Mempool' or 'Compress' or 'Misc' or 'Regex' devices found

3.3.2 绑定失败常见错误码

• Error: bind failed for 0000:03:00.0 - Cannot bind to driver vfio-pci：通常是因为 iommu 未开启或 vfio-pci 模块未加载。检查 dmesg | grep -i iommu 和 lsmod | grep vfio。
• Error: device 0000:03:00.0 is already bound to kernel driver：设备已被其他内核驱动占用，需要先解绑。使用 dpdk-devbind.py -u 0000:03:00.0 解绑。
• Warning: no driver for device 0000:03:00.0：设备没有可用的 DPDK 驱动。检查 CONFIG_RTE_LIBRTE_* 编译选项是否包含该网卡。

3.4 lshw：硬件拓扑与资源视图

lshw（Hardware Lister）提供比 lspci 更丰富的硬件拓扑信息，包括 NUMA 节点、内存映射、IRQ 分配 等。在 DPDK 多队列和 NUMA 亲和性优化中，lshw 的输出是关键的参考依据。

3.4.1 网卡相关诊断命令

典型输出示例：

# lshw -class network -businfo
Bus info          Device      Class          Description
========================================================
pci@0000:03:00.0  eth0        network        Ethernet Controller XXV710
pci@0000:03:00.1  eth1        network        Ethernet Controller XXV710
pci@0000:18:00.0  eth2        network        Ethernet Connection X722

# lshw -class network | grep -A 5 "*-network"
  *-network
       description: Ethernet interface
       product: Ethernet Controller XXV710
       vendor: Intel Corporation
       physical id: 0
       bus info: pci@0000:03:00.0
       logical name: eth0
       version: 02
       serial: a0:36:9f:12:34:56
       size: 10Gbit/s
       capacity: 25Gbit/s
       width: 64 bits
       clock: 33MHz
       capabilities: pm msi msix pciexpress bus_master cap_list ethernet physical
       configuration: autonegotiation=on broadcast=yes driver=ice driverversion=1.12.1
       resources: irq:47 memory:91000000-9107ffff memory:91080000-910fffff

3.5 工具组合使用：故障排查实战流程

当遇到网卡绑定失败时，按照以下流程组合使用四个工具，可以系统性地缩小问题范围：

1. Step 1：硬件存在性检查 — lspci -v -k | grep -A 5 "Ethernet"
   确认目标网卡出现在 PCI 总线上，且 Kernel driver in use 字段存在。
2. Step 2：驱动与固件版本检查 — ethtool -i eth0
   记录驱动版本和固件版本，与 DPDK 兼容矩阵比对。
3. Step 3：绑定状态快照 — dpdk-devbind.py -s
   查看当前哪些设备已绑定 DPDK 驱动，哪些仍被内核管理。
4. Step 4：硬件拓扑确认 — lshw -class network -businfo
   确认 NUMA 节点和 PCI 地址映射，为后续内存分配做准备。
5. Step 5：尝试绑定并捕获错误 — dpdk-devbind.py -b vfio-pci 0000:03:00.0
   如果失败，结合 dmesg | tail -20 查看内核日志。

3.6 工具链对比总结