Reservation 系列导航
UNH-IOL Reservation 一致性测试用例【1】- Reservation Report 命令验证
UNH-IOL Reservation 一致性测试用例【2】- Reservation注册
UNH-IOL Reservation 一致性测试用例【3】- 取消注册
UNH-IOL Reservation 一致性测试用例【4】- Reservation Acquire 验证
UNH-IOL Reservation 一致性测试用例【5】- Reservation Release
UNH-IOL Reservation 一致性测试用例【6】- 抢占 Reservation
UNH-IOL Reservation 一致性测试用例【7】- 清除Reservation
UNH-IOL Reservation 一致性测试用例【8】- 在不同 Reservation Types 下的命令行为
UNH-IOL Reservation 一致性测试用例【9】- Reservation Notification Log Page（LID 0x80）
Test 7.8 -- Command Behavior with Different Reservation Types (M, OF-FYI)
NVMe 支持 6 种 Reservations：
- Write Exclusive
- Exclusive Access
- Write Exclusive - Registrants Only
- Exclusive Access - Registrants Only
- Write Exclusive - All Registrants
- Exclusive Access - All Registrants
这些 reservation 类型之间的区别在于：被排除的访问类型（即 writes 或 all accesses）、registrants 是否具有与 reservation holder 相同的访问权限，以及 registrants 是否也被视为 reservation holder。
就保留类型而言，以下命令被视为 NVM Read Command Group：
- Read
- Compare
- Security Receive
以下命令被视为 NVM Write Command Group：
- Write
- Write Uncorrectable
- Dataset Management
- Flush
- Format NVM
- Namespace Attachment
- Namespace Management
- Security Send
Case 1: Write Exclusive (M, OF-FYI) Dual Port Devices Only
Write Exclusive reservation 禁止 registration holder 以外的任何 host 从 NVM Write Command Group 中发出命令。任何 Host 仍可执行 NVM Read Command Group 的任何命令。
该测试要求 NVM Subsystem 中至少有两个具有 shared namespace 的控制器。
测试步骤
- 检查 Identify controller data structure(CNS 01) ONCS 字段确定 controller 是否支持 reservation；检查DUT当前是否为多个ports
- NVMe Host 1 向 Controller 1 发出 Set Features Host Identifier， 以便为该 Controller 注册一个 Host Identifier
- NVMe Host 2 向 Controller 2 发出 Set Features Host Identifier， 为该 Controller 注册一个不同于 Host 1 的 Host Identifier
- Host 1 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 1 提供 reservation key，以使 host 成为该 shared namespace 的 registrant。
- Host 1 发出 Reservation Acquire 命令，将 Reservation Acquire Action (RACQA) 字段设为 000b (Acquire)，向 Current Reservation Key (CRKEY) 字段提供当前 Host 1 的 reservation key，并将 Reservation Type (RTYPE) 字段设为 Write Exclusive，以便 host 1 在 namespace 获取该 reservation 类型的 reservation
- 所有 Host 向 controller 发送上述 NVM Read Command Group 中的每条命令
- 所有 Host 向 controller 发送上述 NVM Write Command Group 中的每条命令
- Host 2 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 2 提供 reservation key，以使 host 成为该 shared namespace 的 registrant
- Host 2 向各自的 controller 发送上述 NVM Read Command Group 中的每条命令
- Host 2 向各自的 controller 发送上述 NVM Write Command Group 中的每条命令
- 对所有 Reservation Controllers 执行 Reservation Release 命令，将 RRELA 字段设为 1(Clear)
预期结果
- 在每个命令完成后，控制器向相关的 Completion Queue 发布一个 completion queue entry，表明该命令的状态
- Host 1 在步骤 6，7 的命令成功
- Host 2 在步骤 6，9 的命令成功，步骤 7，10 的命令失败，返回状态 Reservation Conflict
Case 2: Exclusive Access (M, OF-FYI) Dual Port Devices Only
Exclusive Access reservation 禁止 registration holder 以外的任何 host 从 NVM Write Command Group 或 NVM Read Command Group 中发出命令。
该测试要求 NVM Subsystem 中至少有两个具有 shared namespace 的控制器。
测试步骤 1. 检查 Identify controller data structure(CNS 01) ONCS 字段确定 controller 是否支持 reservation；检查DUT当前是否为多个ports 2. NVMe Host 1 向 Controller 1 发出 Set Features Host Identifier， 以便为该 Controller 注册一个 Host Identifier 3. NVMe Host 2 向 Controller 2 发出 Set Features Host Identifier， 为该 Controller 注册一个不同于 Host 1 的 Host Identifier 4. Host 1 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 1 提供 reservation key，以使 host 成为该 shared namespace 的 registrant。 5. Host 1 发出 Reservation Acquire 命令，将 Reservation Acquire Action (RACQA) 字段设为 000b (Acquire)，向 Current Reservation Key (CRKEY) 字段提供当前 Host 1 的 reservation key，并将 Reservation Type (RTYPE) 字段设为 Exclusive Access，以便 host 1 在 namespace 获取该 reservation 类型的 reservation 6. 所有 Host 向 controller 发送上述 NVM Read Command Group 中的每条命令 7. 所有 Host 向 controller 发送上述 NVM Write Command Group 中的每条命令 8. Host 2 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 2 提供 reservation key，以使 host 成为该 shared namespace 的 registrant 9. Host 2 向各自的 controller 发送上述 NVM Read Command Group 中的每条命令 10. Host 2 向各自的 controller 发送上述 NVM Write Command Group 中的每条命令 11. 对所有 Reservation Controllers 执行 Reservation Release 命令，将 RRELA 字段设为 1(Clear) #### 预期结果 1. 在每个命令完成后，控制器向相关的 Completion Queue 发布一个 completion queue entry，表明该命令的状态 2. Host 1 在步骤 6，7 的命令成功 3. Host 2 在步骤6，7， 9，10 的命令失败，返回状态 Reservation Conflict
Case 3: Write Exclusive - Registrants Only or Write Exclusive - All Registrants (M, OF-FYI) Dual Port Devices Only
Write Exclusive - Registrants Only 或 Write Exclusive - All Registrants reservation 不允许 namespace 的任何非注册者发 NVM Write Command Group 中的命令。所有 Host 仍可发 NVM Read Command Group 种的命令，namespace 的 registrants 仍可发 NVM Write Command Group 中的命令。
Write Exclusive - Registrants Only 和Write Exclusive - All Registrants reservation 类型的区别在于，Write Exclusive - All Registrants 类型的所有 registrants 也被视为 reservation holders。
该测试要求 NVM Subsystem 中至少有两个具有 shared namespace 的控制器。
测试步骤
- 检查 Identify controller data structure(CNS 01) ONCS 字段确定 controller 是否支持 reservation；检查DUT当前是否为多个ports
- NVMe Host 1 向 Controller 1 发出 Set Features Host Identifier， 以便为该 Controller 注册一个 Host Identifier
- NVMe Host 2 向 Controller 2 发出 Set Features Host Identifier， 为该 Controller 注册一个不同于 Host 1 的 Host Identifier
- Host 1 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 1 提供 reservation key，以使 host 成为该 shared namespace 的 registrant。
- Host 1 发出 Reservation Acquire 命令，将 Reservation Acquire Action (RACQA) 字段设为 000b (Acquire)，向 Current Reservation Key (CRKEY) 字段提供当前 Host 1 的 reservation key，并将 Reservation Type (RTYPE) 字段设为 Write Exclusive - Registrants Only 或 Write Exclusive - All Registrants，以便 host 1 在 namespace 获取该 reservation 类型的 reservation
- 所有 Host 向 controller 发送上述 NVM Read Command Group 中的每条命令
- 所有 Host 向 controller 发送上述 NVM Write Command Group 中的每条命令
- Host 2 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 2 提供 reservation key，以使 host 成为该 shared namespace 的 registrant
- Host 2 向各自的 controller 发送上述 NVM Read Command Group 中的每条命令
- Host 2 向各自的 controller 发送上述 NVM Write Command Group 中的每条命令
- 对所有 Reservation Controllers 执行 Reservation Release 命令，将 RRELA 字段设为 1(Clear)
预期结果
- 在每个命令完成后，控制器向相关的 Completion Queue 发布一个 completion queue entry，表明该命令的状态
- Host 1 在步骤 6，7 的命令成功
- Host 2 在步骤 6 的命令成功，步骤 7 的命令失败，返回状态 Reservation Conflict
- Host 2 在步骤 9，10 的命令成功
Case 4: Exclusive Access - Registrants Only or Exclusive Access - All Registrants (M, OF-FYI) Dual Port Devices Only
Exclusive Access - Registrants Only 或 Exclusive Access - All Registrants reservation 不允许 namespace 的任何非注册者发 NVM Write Command Group 或 NVM Read Command Group 中的命令。Registrants 仍可发 NVM Read Command Group 和 NVM Write Command Group 中的命令。
Exclusive Access - Registrants Only 和 Exclusive Access - All Registrants reservation 类型的区别在于，Write Exclusive - All Registrants 类型的所有 registrants 也被视为 reservation holders。
该测试要求 NVM Subsystem 中至少有两个具有 shared namespace 的控制器。
测试步骤
- 检查 Identify controller data structure(CNS 01) ONCS 字段确定 controller 是否支持 reservation；检查DUT当前是否为多个ports
- NVMe Host 1 向 Controller 1 发出 Set Features Host Identifier， 以便为该 Controller 注册一个 Host Identifier
- NVMe Host 2 向 Controller 2 发出 Set Features Host Identifier， 为该 Controller 注册一个不同于 Host 1 的 Host Identifier
- Host 1 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 1 提供 reservation key，以使 host 成为该 shared namespace 的 registrant。
- Host 1 发出 Reservation Acquire 命令，将 Reservation Acquire Action (RACQA) 字段设为 000b (Acquire)，向 Current Reservation Key (CRKEY) 字段提供当前 Host 1 的 reservation key，并将 Reservation Type (RTYPE) 字段设为 Exclusive Access - Registrants Only 或 Exclusive Access - All Registrants，以便 host 1 在 namespace 获取该 reservation 类型的 reservation
- 所有 Host 向 controller 发送上述 NVM Read Command Group 中的每条命令
- 所有 Host 向 controller 发送上述 NVM Write Command Group 中的每条命令
- Host 2 发 Reservation Register 命令，Register Action (RREGA) 字段设为 000b (即. Register Reservation Key)，在 New Reservation Key (NRKEY) 字段中向 namesapce 的 NVMe Controller 2 提供 reservation key，以使 host 成为该 shared namespace 的 registrant
- Host 2 向各自的 controller 发送上述 NVM Read Command Group 中的每条命令
- Host 2 向各自的 controller 发送上述 NVM Write Command Group 中的每条命令
- 对所有 Reservation Controllers 执行 Reservation Release 命令，将 RRELA 字段设为 1(Clear)
预期结果
- 在每个命令完成后，控制器向相关的 Completion Queue 发布一个 completion queue entry，表明该命令的状态
- Host 1 在步骤 6，7 的命令成功
- Host 2 在步骤 6 ，7 的命令失败，返回状态 Reservation Conflict
- Host 2 在步骤 9，10 的命令成功
注意事项
目前尚未确定进行此项检测的可靠方法。因此，这项测试不应纳入任何行业批准的一致性认定中。