Discovery服务过程跟踪

对于NVMe over Fabrics的subsystem,有两种类型:Discovery子系统和NVM子系统。这里介绍与Discovery子系统相关的交互内容(即:在Linux系统上使用nvme discover命令后的交互过程)。

Discovery子系统无Namespace存储空间,只响应相关的Fabric命令和Admin命令。这也就意味着主机与Discovery子系统只需要NVMe协议规格说明书中定义的Admin Submission Queue,而不需要IO Submission Queue。(之后描述Submission Queue简写SQ,描述Completion Queue简写CQ)。

参考NVMe over Fabrics协议规格说明书1.5.3 Capsules and Data Transfer章节中定义,交互内容格式如下边截图:

SQ请求使用的格式为:(其中前64字节为NVMe Command)

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

CQ回复使用的格式为:(其中前16字节为Completion内容)

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

Discovery子系统可以处理的命令包括Fabric命令和一部分Admin命令:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

接下来按交互过程顺序来介绍。

1. 连接connect命令

此命令归属Fabric命令。

主机initiator端与target端Discovery子系统交互(注意:此connect命令前,需要已经存在Fabric链路作为SQ和CQ),由主机端发起connect命令。

参考下边抓包信息可以看到,connect命令包含了如下关键数值:

opcode为0x7f、命令ID为0、Fabric Command Type为0x01、QueueID为0、Queue最大值31、Keep Alive Timeout为0(不超时)。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

在此交互的Capsule的数据内容大小占用1024字节,包含了主机标识、Controller ID、被请求的NQN、主机NQN,这4个主要内容。

本例子中,Controller ID填写了0xFFFF(65535),表示不指定controller。

允许连接的情况,回复如下内容:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

其中Value: 1表示建立连接的controller的ID号为1。

备注:连接两种NVM子系统的过程是一样的,只是连接Discovery子系统时,请求的NQN是固定的nqn.2014-08.org.nvmexpress.discovery

2. 获取property属性(CAP)

此命令归属Fabric命令。

查询property属性(此属性对应PCIe场景下的register map for the controller),opcode用0x7f,Fabric命令类型为0x04(即表示property Get),如下示例中的查询property属性,Attribute为1表示读取8个字节,offset为0表示从property空间的偏移0开始读取。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

从propert属性定义可以看出,此命令请求目的是获取CAP(Controller Capabilities):

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

补充说明:对于Discovery子系统的控制器来说,只支持如下属性,其他的被Reserved:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

对应的回应如下,此Response回应对应的是命令ID 14,查询出来的内容是CAP属性,值为十六进制ff 03 00 0f 20 00 00 00。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

从NVMe规格说明书中查询CAP的8字节(64 bit)中各bit位表示的意思如下:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

对照可以得出:

15:00对应的值ff 03,表示MQES队列深度可以支持1023(0x03ff=1023)。

23:16对应的值是00,表示CQR不是物理连续的,AMS仲裁机制支持也为0不支持。

31:24对应的值是0f,表示TO,从CC.EN使能到等待CSTS.RDY就绪的最坏超时时间。

37bit设置了1,表示CSS命令集支持,1表示支持NVM command Set。

3. 设置property属性(CC.EN)

此命令归属Fabric命令。

下边截图中,Attributes值为0表示设置4字节,offset是0x14,从前边截图Figure 30 Discovery Controller -properties可以得出是在设置CC(Controller Configuration)。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

参照NVMe规格说明书,Controller Configuration对应bit位的意思,如下边截图Figure 78: Offset 14h: CC - Controller Configuration

本例子中的设置property属性目的是Enable使能controller。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

回应的response如下:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

4. 查询property属性(CSTS.RDY)

本次查询property属性时填写的offset偏移量0x1c,Attribute为0即读取4个字节,参照property属性表可知,本次查询的是CSTS(Controller STATUS)。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

接下来,看回应response的内容:

对应查询命令ID 23的回复值是Value为1。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

参照CSTS对应bit位的意思,可知,本次查询的CSTS.RDY为1,表示Controller已经ready。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

5. 查询property属性(VS)

此命令归属Fabric命令,查询property属性中的offset偏移0x08位置,参照Figue 30即可得知查询的是version版本号。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

回应此命令24的response内容为:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

参照property属性表解释,可得知,Controller使用的NVMe协议版本是1.3.0。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

附加说明:

对于主机端,查询此版本号,可以区分1.1.0版本及以后的版本,CAP中有NSSRC功能,此bit位的意思如下:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

在linux系统中,主机就用查询版本号判断是不是1.1.0版本及以后的版本,来区分是否支持CAP.NSSRC功能。其他的当前还未看到主机端用版本区分功能的地方。

6. 获取property属性(CAP)

获取CAP,本次查询到的信息与使能前查询的到的信息一样。

这里出现了重复查询。本例子是使用的NVMe over TCP方式抓包的,是Linux系统下的操作,相关代码:

nvme_tcp_configure_admin_queue()

--> ctrl->ops->reg_read64(ctrl, NVME_REG_CAP, &ctrl->cap); //读一次

--> nvme_enable_ctrl(ctrl, ctrl->cap);

--> nvme_init_identify(ctrl);

--> ctrl->ops->reg_read32(ctrl, NVME_REG_VS, &ctrl->vs);

--> ctrl->ops->reg_read64(ctrl, NVME_REG_CAP, &cap); //又读一次

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

回应如下:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

以上完成了主机与target端Discovery服务的Fabric连接过程。

接下来开始进行Admin Command处理分析。

7. Identify查询命令id-ctrl(Admin Command)

此命令归属Admin Command。

执行nvme id-ctrl命令的结果。

这里Identify查询命令,opcode为0x06,CNS字段填充0x01,表示查询controller Identify,注意:Discovery只定义了CNS为0x01的处理,其他情况未定义。

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

结合上边Figure 33: DiscoveryController - Identify Controller Data Structure回应内容解析,可知回应的内容大小为3072字节。

本例子操作时获取到的回应数据为:

Completion Queue Entry对应的16字节内容为:

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

接下来数据参照Figure 33分析:

Firmware Revision (FR): 5.0.7

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

Maximum Data Transfer Size (MDTS): 0 //固定填写0

Controller ID (CNTLID): 1

Version (VER): 1.3.0

Log Page Attributes (LPA): 0x04

Error Log Page Attributes (ELPE): 0x00

Maximum Outstanding Commands (MAXCMD): 0x00000000

SGL Support (SGLS): 0x00000000

NVM Subsystem NVMe Qualified Name (SUBNQN): 固定字符串

NVMe over Fabrics 协议Discovery服务交互过程跟踪-LMLPHP

备注:

测试时使用了NVMe over TCP,分析截图使用了wirshark,需要wirshark 3.0.3之后的版本。

05-11 22:18