USBIP主机/远程端口/总线ID存储位置及连接记录错误排查

相关参数的存储位置 #

• 连接记录与端口状态文件：默认存储在/var/lib/usbip/目录下，包含usbipd服务运行时的状态数据及设备连接记录。
• busid/rhport：对应USB设备的busnum和devnum可在/sys/bus/usb/devices/<设备路径>/busnum、/sys/bus/usb/devices/<设备路径>/devnum中读取；rhport（根集线器端口）对应设备目录下的port文件，比如/sys/bus/usb/devices/9-1/port。
• usbip_port_string：由vhci_hcd内核模块维护在sysfs节点中，路径通常为/sys/devices/platform/vhci_hcd.<实例编号>/ports/<端口号>/port，实例编号和端口号根据实际加载情况变化。
• usbip-host绑定信息：加载usbip-host模块后，可在/sys/bus/usb/drivers/usbip-host/下查看已绑定的设备busid。

文件被内核/进程锁定的可能原因 #

• initramfs属于早期启动环境，默认未挂载/var分区，usbip依赖的/var/lib/usbip/目录不存在或为临时文件系统，导致无法读写状态文件。
• usbip相关内核模块（usbip-core、usbip-host、vhci_hcd）运行时会独占访问sysfs节点，若模块未正确初始化，节点未创建则会触发读取错误。
• 若usbipd进程在initramfs阶段已启动，会锁定/var/lib/usbip/下的状态文件，后续命令无法打开。

排查步骤 #

• 确认文件系统挂载：在initramfs hook中添加创建/var/lib/usbip/目录的逻辑，或临时指定usbip使用tmpfs存储状态，执行命令时加上--usbip-dir=/tmp/usbip参数。
• 验证模块加载顺序：确保先加载usbip-core，再加载usbip-host、vhci_hcd（注意：vudc是虚拟UDC驱动，用于USB gadget，与usbip-host导出设备的场景无关，若不需要可移除）。
• 检查sysfs节点：加载模块后执行ls /sys/bus/usb/drivers/usbip-host/和ls /sys/devices/platform/vhci_hcd*，确认相关节点存在。
• 权限与文件存在性：在initramfs中手动检查/var/lib/usbip/或临时目录的权限（设置为root:root 755），确保目录可读写。
• 调试命令输出：执行usbip --debug port获取更详细的错误日志，定位具体哪个文件无法打开或读取。

内容的提问来源于stack exchange，提问作者beercarrier