当诊断程序运行时，它会在屏幕上以以下格式显示测试进度

“Running test X on GPU n - Y tests remaining  |=======  | Z %”

其中

X 是序列中的当前测试编号

n 是 GPU 编号

Y 是剩余测试的数量

Z 是总体完成百分比

示例

Running test 208 on GPU 0 - 118 tests remaining   |===================   | 64 %

完成时，如果诊断程序正常完成，将向 shell 返回 0。如果发生错误，将向 shell 返回 1，如果需要重新测试，将返回 2。它还将在屏幕上打印“PASS”、“FAIL”或“RETEST”。

• PASS – 硬件通过诊断
• FAIL – 硬件未能通过诊断
• RETEST – 硬件设置未能通过诊断的预检查部分，并且出现警告消息描述问题。根据预检查消息纠正问题，然后再次测试。

默认情况下，现场诊断会生成一个二进制日志文件，NVIDIA 工程师使用该文件来诊断故障卡。日志文件的名称包含基本的测试结果信息以及被测板卡的序列号

fieldiag_<PASS/FAIL/CONFIG>_<序列号>.log

• 通过板卡的日志文件名称示例：“fieldiag_PASS_1234567.log”。
• 故障板卡的日志文件名称示例：“fieldiag_FAIL_1234567.log”。
• 初始 SKU 配置失败的板卡的日志文件名称示例：“fieldiag_CONFIG_1234567.log”。

如果系统中测试了多张卡，则日志文件的名称中会包含第一个 GPU 的序列号。

如果问题阻止从卡中读取序列号，则返回的文件名将不包含序列号。

通常，通过使用以下命令行调用现场诊断

• fieldiag（测试系统中找到的所有 GPU）

表 1 列出了可选的命令行参数，并简要描述了每个参数。下一节将给出进一步的解释。

Linux 现场诊断依赖于内核驱动程序来处理需要使用内核模式 API 的情况。安装现场诊断内核模块的最简单方法是使用提供的安装脚本，您将在现场诊断运行空间中找到该脚本

$ ./install_module.sh --install

[注意：您无法从 root 用户没有写入权限的网络目录安装内核模块。在这种情况下，请将 install_module.sh 和 driver.tgz 复制到 /tmp 并在那里运行。]

此脚本还在 /etc/udev/rules.d/99-mods.rules 中创建一个 udev 配置文件。此文件指定可以访问内核模块的组。默认情况下，这是视频组，例如 NVIDIA 驱动程序的视频组。确保您的用户在此组中，或更改 99-mods.rules 文件中的组以匹配您的组之一。在某些系统上，安装脚本创建了文件 /etc/udev/permissions.d/99-mods.permissions，该文件仅列出驱动程序文件的用户、组和模式。

要找出驱动程序已分配给哪个组，请输入

$ ls -l /dev/mods

crw-rw---- 1 root video 10, 60 Jan  7 08:21 /dev/mods

要找出您所在的组，请输入

$ id

uid=4384(modsuser) gid=30(hardware) groups=30(hardware),1606(gpu-tesla)

如果您决定修改 99-mods.rules 中的组，则必须重新加载内核模块

$ modprobe -r mods

$ modprobe mods

要确保内核模块在系统启动时始终加载，请遵循您的发行版特定的指南。

在基于 Debian 的发行版（例如 Ubuntu）上，如果安装脚本没有添加 mods 模块名称，请将其添加到 /etc/modules。

在基于 SuSE 的发行版上，将 mods 模块名称添加到 /etc/sysconfig/kernel 文件中的 MODULES_LOADED_ON_BOOT 变量中。

在基于 RedHat 的发行版（例如 CentOS）上，将行 modprobe mods 添加到 /etc/rc.d/rc.local。

如果您在 Linux 发行版上运行了旧版本的现场诊断，则旧的 MODS 内核模块将与较新的现场诊断冲突并导致故障。

在运行较新的现场诊断之前，请按如下方式删除旧的 MODS 内核模块

1. 导航到现场诊断子目录。
2. 从命令行运行

 ./install_module.sh –u

当您运行较新的现场诊断时，将自动安装更新的 MODS 内核模块。