【NVMe2.0b 16-1】Get Log Page

5.16Get Log Page command

Get Log Page 命令返回包含请求的 log page 的数据缓冲区。Get Log Page 命令可能会受到 ANA 状态的影响（请参阅第 8.1.4 节）。

Get Log Page 命令使用 Data Pointer、Command Dword 10、Command Dword 11、Command Dword 12、Command Dword 13 和 Command Dword 14 字段。保留所有其他命令特定字段。

在第 3.1.2.1.2 节、第 3.1.2.2.2 节和第 3.1.2.3.3 节中定义了强制和可选的 Log Identifier。如果处理了指定不支持的 Log Identifier 的 Get Log Page 命令，则控制器应使用 Invalid Field in Command 状态码中止该命令。

控制器在 Identify Controller data structure 的 Log Page Attributes 字段中指示支持 Log Page Offset 和 extended Number of Dwords（32 位而不是 12 位）。如果不支持扩展数据，则 Number of Dwords Lower 字段的位 27:16 指定要传输的 Dwords 数。

如果支持 Log Page Offset，则:

所有 log pages 都应支持 byte offset（即，Offset Type 字段清为“0”）；
对于在 LID Supported and Effects Data Structure log page（参见Figure 204）中将指定 LID 的 IOS 位设置为“1”的每个log page（参见Figure 204），应支持 index offset（即，Offset Type 字段设置为“ 1’）。

如果在 LID Supported and Effects Data Structure log page 中指定 LID 的 IOS 位被清为“0”，并且 Get Log Page 命令指定 Offset Type 字段设置为“1”，则该命令应以Invalid Field in Command 状态码中止。

Figure 196: Get Log Page – Data Pointer

Bits	Description
127:00	Data Pointer (DPTR): 该字段指定数据缓冲区的开始。有关该字段的定义，请参见Figure 87。

Figure 197: Get Log Page – Command Dword 10

Figure 198: Get Log Page – Command Dword 11

Figure 199: Get Log Page – Command Dword 12

Figure 200: Get Log Page – Command Dword 13

Bits	Description
31:00	Log Page Offset Upper (LPOU): 除非另有说明，否则此字段指定 log page offset 或数据结构列表中的 index 的最高有效 32 位。请参阅 Log Page Offset Lower 定义。

如果控制器支持通过 Get Log Page 命令选择 UUID（参见Figure 202 和第 8.25 节），则Command Dword 14 用于指定 UUID Index 值（参见Figure 201）。

Figure 201: Get Log Page – Command Dword 14

5.16.1Log Specific Information

Figure 202 定义了可以使用 Get Log Page 命令检索的 log page 以及在这些 log page 中返回的信息的范围。有关各种控制器类型的强制、可选和禁止的 log page ，请参阅第 3.1.2.1.2 节、第 3.1.2.2.2 节和 3.1.2.3.3 节。

指示 NVM 子系统范围的 log page 返回 NVM 子系统的全局信息。指示 Domain 范围的 log page 返回对域来说是全局的信息。指定 Controller 范围的 log page 返回特定于正在处理命令的控制器的信息。指定 Namespace 范围的 log page 返回特定于指定命名空间的信息。对于指定多个范围的 log page ，对多个domains的支持或指定的NSID决定了返回哪些信息。log page 中任何单个字段的定义可能指示特定于该单个字段的不同范围。

对于具有 NVM 子系统或 Controller 范围的 log page （如Figure 202 所示），控制器应中止指定NSID不是 0h 或 FFFFFFFFh的命令，返回状态码为 Invalid Field in Command 。否则，适用 Figure 87 中的NSID使用规则。

Figure 202: Get Log Page – Log Page Identifiers