UOS Server 20下MLNX_OFED驱动编译踩坑实录：从fput缺失到成功安装的全过程

UOS Server 20下MLNX_OFED驱动编译实战：从内核兼容性到模块修复的深度解析

在国产操作系统生态快速发展的今天，UOS Server 20作为企业级Linux发行版，正逐步获得更多行业用户的青睐。然而，当我们需要在UOS上部署高性能网络设备时，第三方驱动的兼容性问题往往成为技术团队面临的首要挑战。本文将详细记录在UOS Server 20（内核版本4.19.90）上编译安装Mellanox官方OFED驱动套件时遇到的内核函数缺失问题及其系统化解决方案。

1. 环境准备与问题初现

在开始编译MLNX_OFED驱动前，必须确保基础环境配置正确。我们使用的测试平台配置如下：

系统信息确认：

cat /etc/os-release uname -r

硬件与软件关键参数对照表：

注意：尽管官方文档标注支持UOS20，但实际内核函数导出可能存在差异，建议提前备份系统重要数据。

执行标准安装流程时，我们遇到了第一个关键错误：

./mlnx_add_kernel_support.sh -m /root/MLNX_OFED_LINUX-24.10-2.8.0-uos20.1060-x86_64

通过日志分析工具快速定位问题根源：

tail -n 50 /tmp/mlnx_iso.*_logs/OFED.*.logs/mlnx-nvme-*.rpmbuild.log

2. 内核函数缺失的深度分析

编译过程中报错明确指向fput函数未定义，这个看似简单的错误背后隐藏着UOS内核与标准内核的微妙差异。fput作为Linux内核文件操作的核心函数，通常定义在linux/file.h头文件中，其功能是减少文件引用计数。

问题本质分析：

• UOS内核可能修改了函数导出符号表
• 内核头文件与实际运行内核版本不一致
• 驱动代码未考虑国产系统的特殊修改

通过内核源码比对，我们发现关键差异点：

// 标准Linux内核中的定义 void fput(struct file *file); // UOS内核中的实际实现 void __fput(struct file *file);

解决方案技术路线图：

1. 提取MLNX驱动源码包中的NVMe模块
2. 修改函数调用适配UOS内核
3. 重新构建RPM软件包
4. 替换驱动安装脚本中的组件

3. 驱动模块的定制化修改

获取原始源码是解决问题的第一步，需要特别注意MLNX驱动包的特殊结构：

tar xzvf MLNX_OFED_SRC-24.10-2.1.8.0.tgz rpm -ivh MLNX_OFED_SRC-24.10-2.1.8.0/SRPMS/mlnx-nvme-*.src.rpm

关键修改集中在TCP传输模块的实现文件：

// 原代码片段 ret = filp_open(path, flags, mode); if (IS_ERR(ret)) { fput(ret); // 问题点 return PTR_ERR(ret); } // 修改后版本 ret = filp_open(path, flags, mode); if (IS_ERR(ret)) { __fput(ret); // 适配UOS内核 return PTR_ERR(ret); }

模块重构完整流程：

1. 解压源码到构建目录：

   cd /root/rpmbuild/SOURCES tar xzvf mlnx-nvme-24.10.tgz

2. 执行代码修改后重新打包：

   tar czvf mlnx-nvme-24.10.tgz mlnx-nvme-24.10 rpmbuild -ba /root/rpmbuild/SPECS/mlnx-nvme.spec

3. 解决依赖文件缺失问题：

   cp -r /tmp/mlnx_iso.*/usr/src/ofa_kernel /usr/src/

4. 系统级集成与验证测试

完成模块修改后，需要将定制化组件集成到原始安装流程中。这一阶段需要特别注意安装脚本的执行顺序和临时文件处理。

安装脚本关键修改点：

# 在mlnx_add_kernel_support.sh中添加预处理步骤 CUSTOM_RPM="/root/mlnx-nvme-24.10-*.src.rpm" if [ -f "$CUSTOM_RPM" ]; then rpm -ivh $CUSTOM_RPM cp $CUSTOM_RPM /tmp/mlnx_iso.${PID}_pkgs/ fi

安装后验证流程：

1. 驱动加载状态检查：

   modinfo mlx5_core lsmod | grep mlx

2. 网络端口识别测试：

   ibstat ip link show

3. 性能基准测试（可选）：

   ib_send_bw -d mlx5_0 ib_read_lat -d mlx5_0

常见问题排查指南：

整个过程中最关键的收获是：在国产操作系统上部署第三方驱动时，不能简单依赖官方文档的兼容性声明，而应该建立系统化的验证机制。通过本次实践，我们总结出一套适用于UOS的驱动适配方法论——从内核符号分析到模块定制编译，再到系统集成验证，每个环节都需要严谨的技术论证和反复测试。