"Manual" 模式下的 UEFI 诊断

如果选择 "Manual" 诊断测试级别，将在 "Manual" 模式下运行 UEFI 诊断。使用 "Manual" 模式时，必须输入 CLI 命令才能运行 UEFI 诊断测试。

"Manual" 级别诊断测试输出可通过连接到系统的显示器、串行控制台或 KVM 进行查看。测试结束后，必须手动将系统设置回 "Disabled" 级别。

有关 UEFI 命令选项的列表，请参见UEFI 诊断 CLI 命令。有关查看 UEFI 诊断输出的信息，请参见UEFI 诊断输出。

以下各节提供了有关在手动模式下使用 UEFI 诊断的一般 CLI 使用信息。

• 资源要求

• 基本命令语法

• 命令标志

资源要求

本节介绍针对各 UEFI 诊断命令记录的处理器资源要求和实例限制。下表提供了有关处理器属性和实例属性的说明。

资源要求 说明 BSP_ONLY 命令仅在启动捆绑处理器 (boot strap processor, BSP) 上运行。它不应在应用处理器 (application processor, AP) 上运行。 ONE_AP_OR_BSP 命令可以同时在 BSP 或任何一个 AP 上运行。 ANY_PROC 命令可以在任何 AP 或 BSP 上运行。 ONE_INSTANCE_ONLY 一次只能运行命令的一个实例。 MULTIPLE_INSTANCES 可同时运行两个或更多命令副本。

基本命令语法

本节介绍本指南中使用的基本 CLI 语法约定。

在本文档中，CLI 命令显示为 monospace 字体。fs0:/> 字符表示 UEFI shell 命令提示符的示例，不应作为命令的一部分进行输入。

约定 说明 { } 花括号表示必选项。 [ ] 方括号表示可选项。 <italics> 斜体表示变量。使用某个值代替变量。 | 花括号中的竖线表示必须选择一项，方括号中的竖线表示可以选择一项。

例如，在以下命令语法中：

udiag storage mst { all | <device_name> } [ -time <n> ]

• udiag storage mst－表示要启动的 UEFI 诊断测试。

• all | <device_name>－表示要么选择测试所有存储设备，要么选择测试在 device_name 变量中输入的特定存储设备。

• -time <n>－表示可以选择在 n 变量中输入的特定时间段内测试存储设备。

命令标志

本节介绍与 UEFI 诊断结合使用的命令标志。

UEFI 诊断分两步处理命令标志。第一步，将在任何命令之前（但在 udiag 之后）出现的标志作为之后命令的设置标志进行解析和处理。第二步，将某个命令之后的标志仅用于覆盖该命令的设置。

标志 参数 说明 -h、-?、-help 显示命令帮助信息。 -Q、-q、-n、-v、-V 相互排斥的标志，可以指定可能会输出的信息命令的数量。-n 为默认值。-Q 或 -q 表示不显示输出，-V 或 -v 表示显示详细输出。 -w <byte_size> 以字节为单位指定寄存器和存储器单元的存取大小。<byte_size> 必须为 1、2、4 或 8 中的一个。默认大小为 8。 -pc <n> 重复一个命令，直到经过 <n> 次通过。默认值为 1。 -ec <n> 重复一个命令，直到出现 <n> 次错误。默认值为 1。 -time <n> 将运行限制到 <n> 秒。默认值为 0，表示没有限制。 -l <log_file> 将所有控制台输出复制到 <log_file>。log_file 必须采用以下格式： <volume>:<hierarchical_file_name> 其中： hierarchical_file_name = [\<file_or_folder_name>]+ 如下例所示： -l fs0:\test1.log -s <begin> 指定一个特定于命令的 64 位普通十六进制数字。例如，内存测试将其用作要测试的内存范围的最低地址。 -e <end> 指定一个特定于命令的 64 位普通十六进制数字。例如，内存测试将其用作要测试的内存范围的最高地址加一个字节。 -np <n> | all 指定要使用的应用处理器 (application processor, AP) 数量。常量 all 指定要使用所有已启用的处理器。 -ap <n>[/<n>]* 指定要使用的一个或多个特定 AP。处理器编号 0 预留供启动捆绑处理器 (boot strap processor, BSP) 使用，不应与此标志结合使用。 所有 AP 均使用 1 到 SMBIOS 表报告的最大启用处理器数进行编号。 例如，-ap 5f/1/10 可为命令分配处理器 5f、1 和 10。例如，内存测试可以按照所列顺序将 AP 分配给测试范围内的子块（依次从最低地址的子块开始）。典型的应用是通过分配远离其子块的处理器，在插槽互连上生成尽量多的背景流量。

输入 CLI 命令时，请注意以下规则：

• 大多数命令都支持 -h、-?、-help、-n、-v、-V、-pc 和 -ec 标志。

• 具备 AP 功能的命令支持 -np 和 -ap 标志。

• 长时间运行的测试（如 memory、storage、fpu 和 simd 测试）支持 -time 标志。

• 右方括号后的后缀 *（例如，[<n>]*）表示有 0 个或更多重复选项。

• 右方括号后的后缀 +（例如，[\<file_or_folder_name>]+）表示有 1 个或多个重复选项。