NVMe1.4Admin Command学习（4）-- valid virtualization management

1.Virtualization Management

       虚拟化管理命令由支持虚拟化增强功能的主控制器支持。这个命令用于几个函数：修改主控制器的灵活资源分配；为二级控制器分配灵活的资源；设置副控制器的联机和脱机状态。

虚拟化管理命令使用命令dword10和命令dword11字段。所有其他特定于命令的字段都被保留。

Figure 323: Virtualization Management – Command Dword 10

bits	descriptions
31:16	Controller Identifier (CNTLID):此字段指示要为其修改控制器资源的控制器。
15:11	reserved
10:08	Resource Type(RT):此字段指示要修改的控制器资源的类型。 value description 000b VQ Resources 001b VI Resources 010b to 111b reserved
07:04	reserved
03:00	action(ACT):此字段指示命令要执行的操作，如下所述。 value descriptions 0h reserved 1h Primary Controller Flexible Allocation：在下一次控制器级别重置(而不是一次控制器重置)之后(例如，CC.EN从“1”转换为“0”)，设置分配给这个主控制器的灵活资源的数量。如果控制器标识符字段与此主控制器不对应，则返回无效控制器标识符的错误。此值在整个电源周期和重置中持续存在。 2-6h reserved 7h Secondary Controller Offline：将二级控制器置于脱机状态，删除所有灵活资源。如果控制器标识符字段与与此主控制器相关联的辅助控制器不对应，则返回无效控制器标识符的错误。 8h Secondary Controller Assign：将控制器资源数量中指定的控制器资源数量分配给辅助控制器。如果控制器标识符字段与与此主控制器相关联的辅助控制器不对应，则返回无效控制器标识符的错误。如果辅助控制器不处于脱机状态，则返回无效辅助控制器状态的错误 9h Secondary Controller Online：将二级控制器置于联机状态。如果控制器标识符字段与与此主控制器相关联的辅助控制器不对应，则返回无效控制器标识符的错误。如果辅助控制器没有适当地配置(参见8.5节)或主控制器没有启用，则返回一个无效的辅助控制器状态的错误。 A-Fh reserved

Figure 324: Virtualization Management – Command Dword 11

bits	descriptions
31:16	reserved
15:0	Number of Controller Resources (NR):该字段指示要allocate 或者 assign的控制器资源的数量

与虚拟化管理命令相关联的命令特定的状态值在图325中定义。

Figure 325: Virtualization Management – Command Specific Status Values

value	description
1F	Invalid Controller Identifier:指定了无效的控制器标识符
20F	Invalid Secondary Controller State:根据辅助控制器及其主控制器的当前状态，为辅助控制器请求的操作无效
21F	Invalid Number of Controller Resources:指定的灵活资源数量无效(如控制器资源数(NR)大于VQ资源灵活总数(VQFRT)(见图252)，控制器资源数(NR)大于VQ资源灵活次最大值(VQFRSM)
22F	Invalid Resource Identifier:至少有一个指定的资源标识符无效(例如，控制器资源的数量(NR)大于剩余可用的灵活资源的数量)。

完成队列条目的Dword 0包含有关被修改为主控制器灵活分配和辅助控制器分配操作的一部分的控制器资源的信息。图326中定义了完成队列条目的Dword 0。

Figure 326: Virtualization Management – Completion Queue Entry Dword 0

bits	descriptions
31:16	reserved
15:00	Number of Controller Resources Modified(NRM):这个字段表示分配或分配的控制器资源的数量。该值可能比请求的数字小或大。