【变更声明】IPMI命令Get User Access请求体通道号无效时返回值变更

变更声明

IPMI接口中Get User Access命令通道号校验返回码,如果通道号请求无效会报错。
在openUBMC25.09版本支持了多网口下的IPMI通道设置功能,同步将通道号异常时的错误码变更( 【已评审】新增资源树协作接口支持IPMI通道权限配置 - #4 )。
导致单通道场景,传入无效通道后的响应错误码:

  • openUBMC 25.09版本:
    0xd5(IPMICommandCannotExecute,无法执行IPMI命令)
  • openUBMC 25.06及更早的版本:
    0xcc(IPMIInvalidFieldRequest,请求中有无效字段)

为了保证单网口及历史版本兼容,申请将通道号请求无效时的错误码变更为0xcc。
详细变更内容请见评审材料:

受影响的版本

  • openUBMC 25.09

变更描述

规格变化

不涉及

外观变化

不涉及

外部接口变化

2.1 IPMI 标准命令

IPMI Get User Access

命令名称: Get User Access
命令说明: 获取BMC用户访问权限
命令权限: UserMgnt
是否锁定之后可以访问:
是否有敏感数据:
命令样式:

  • 请求:ipmitool raw 0x06 0x44 <channel_number> <user_id>
  • 响应:<Completion Code> <Maximum Number Of User IDs> <Enabled User IDs> <User IDs With Fixed Names> <Channel Access>
变更前
  • 查询某用户在某通道的权限,如果此通道号传入为无效通道,Completion Code为:
    D5h =【标准完成码】用户无访问通道权限
变更后
  • 查询某用户在某通道的权限,如果此通道号传入为无效通道,Completion Code为:
    CCh =【标准完成码】通道号校验失败