【待评审】IPMI新增查询、清除带内部件信息收集完成标志的命令

Interface SIG Interface评审
1

ISSUE 链接

闭源组件修改，不涉及社区ISSUE。

背景

当前ipmi已有启动、停止或查询整机部件信息的命令。用户可以调用这些命令完成对采集整机部件信息的需求。但是，由于历史实现缺乏带内部件收集完成标志，造成用户无法精准判断是否完整且正确收集带内部件信息，从而重复启动带内部件信息收集，影响效率。

当前方案需要在带内部件信息采集成功后，在BMC侧设置复位持久化的完成标志。用户通过新增的ipmi命令查询、清除该完成标志。

评审点

评审点1：IPMI 新增查询带内部件信息完成标志的命令

命令名称： GetCollectServerInformationResult
命令说明： 查询查询带内部件信息完成标志
命令权限： ReadOnly
是否锁定之后可以访问： 是
是否有敏感数据： 否
命令样式：

  • 请求：ipmitool raw 0x30 0x93 0xDB 0x07 0x00 0x8A 0X02 0X00 0X01
  • 响应：00 db 07 00 00
字节顺序 域取值说明
NetFn 30h
Cmd 93h
1:3 Manufacturer ID，LB Byte first。长度固定 3 个字节
例如，某厂家ID时 2011，对应十六进制为0x0007DB，则字节序为：
第一个字节为 DBh
第二个字节为 07h
第三个字节为 00h
4 SubCmd，固定为 8Ah
5 Selector，固定为 01h
6 ReadOffset, 读偏移，固定为 00h
7 Length，数据长度，固定为 01h

命令响应参数：

字节顺序 域取值说明
1 Completion Code，所有的完成码则需要单独和详细说明，比如：
00h =【标准完成码】命令响应成功
CCh = 【标准完成码】命令入参超过支持范围
80h = 【非标完成码】命令的长度和参数不匹配
81h = 【非标完成码】命令的参数无法支持
2:4 Manufacturer ID，LB Byte first。长度固定 3 个字节
例如，某厂家ID时 2011，对应十六进制为0x0007DB，则字节序为：
第一个字节为 DBh
第二个字节为 07h
第三个字节为 00h
5 Result ，下发结果，取值如下：
00h = 未完成带内部件信息收集
01h = 已完成带内部件信息收集

命令示例：

  • 请求：ipmitool raw ipmitool raw 0x30 0x93 0xDB 0x07 0x00 0x8A 0X02 0X00 0X01
  • 响应：00 db 07 00 00

评审点2：IPMI 新增清除带内部件信息完成标志的命令

命令名称： DeleteCollectServerInformationResult
命令说明： 清除带内部件信息完成标志
命令权限： WriteOnly
是否锁定之后可以访问： 是
是否有敏感数据： 否
命令样式：

  • 请求：ipmitool raw 0x30 0x93 0xDB 0x07 0x00 0x8A 0X03 0X00 0X01
  • 响应：00 db 07 00
字节顺序 域取值说明
NetFn 30h
Cmd 93h
1:3 Manufacturer ID，LB Byte first。长度固定 3 个字节
例如，某厂家ID时 2011，对应十六进制为0x0007DB，则字节序为：
第一个字节为 DBh
第二个字节为 07h
第三个字节为 00h
4 SubCmd，固定为 8Ah
5 Selector，固定为 03h
6 WriteOffset，读偏移，固定为 00h
7 Length，数据长度

命令响应参数：

字节顺序 域取值说明
1 Completion Code，所有的完成码则需要单独和详细说明，比如：
00h =【标准完成码】命令响应成功
CCh = 【标准完成码】命令入参超过支持范围
80h = 【非标完成码】命令的长度和参数不匹配
81h = 【非标完成码】命令的参数无法支持
2:4 Manufacturer ID，LB Byte first。长度固定 3 个字节
例如，某厂家ID时 2011，对应十六进制为0x0007DB，则字节序为：
第一个字节为 DBh
第二个字节为 07h
第三个字节为 00h

命令示例：

  • 请求：ipmitool raw ipmitool raw 0x30 0x93 0xDB 0x07 0x00 0x8A 0X02 0X00 0X01
  • 响应：00 db 07 00

评审结论

遗留问题