《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）。

6.15.1 命令完成Command Completion

当命令完成不论成功还是失败，controller都应该发送一个表明命令状态的CQE到关联的I/O CQ完成队列。

写命令特定的错误定义在Figure 406中。

------------------------------------------------------------

【实验】

1、把test.log文件中的内容写入/nvme0n1盘中，参数-d表示指定data file，-z 10表示指定写入的字节数；

2、写成功后，再读出来，-z 10指定读10个字节。

3、实验时用的nvme over tcp，可以用wireshark查看命令内容，有下图可以看出，虽然-z指定了写10个字节，内容是HelloWorld，但还是向namespace1的逻辑块1写入了512字节。

4、读命令