《NVM-Express-1_4-2019.06.10-Ratified》学习笔记（6.15）-- 写命令

6.15 Write command 写命令

写命令写数据和元数据，如果适用介质，发到逻辑块相应的I/O controller。主机也可以指定保护信息，作为操作的一部分包含进来。

命令用Command Dword 10，Command Dword 11，Command Dword 12，Command Dword 13，Command Dword 14，和Command Dword 15区域。如果命令使用PRPs传输数据，那么元数据指针，PRP Entry 1，和PRP Entry 2 域就被使用。【注：NVMe over Fabrics不使用PRP】。如果命令使用SGLs传输数据，那么元数据SGL Segment Pointer和SGL Entry 1域就被使用。

【为帮助直观理解，下图参照linux-5.2.9代码定义，黄色线框内，右侧是把Command Dword10～15定义成了相应内容字段】

Command Dword10～11这64位作为一个变量，其数值表示SLBA逻辑块地址起始位置（表示从0开始的第几个逻辑块）。

Command Dword12被分成两部分：

（1）前16位作为一个变量，其数值表示逻辑块的数（Number of Logical Blocks），注意：这个数值是基于0开始的，即nvme_rw_command.length值为0时表示写一个逻辑块，值为自然数n时表示写n+1个逻辑块。

（2）后16位表示控制信息，依次分别为：4bit保留，4bit表示Directive Type（DTYPE），2bit保留，4bit表示Protection Information Field（PRINFO），1bit表示Force Unit Access（FUA），1bit表示Limited Retry（LR）。

Command Dword13用于DataSet管理

Command Dword14表示Inital Logical Block Reference Tag（ILBRT），此域字段仅用于格式化为端到端保护的namespace的情况。

Command Dword15仅用于端到端保护的情况，此Dword分为两部分：

（1）前16位表示Logical Block Application Tag（LBAT）。

（2）后16位表示Logical Block Application Tag Mask（LBATM）。