昇腾社区首页
中文
注册
开发者
下载

dcmi_get_spod_node_status接口原型

函数原型

int dcmi_get_spod_node_status(int card_id, int device_id, unsigned int sdid, unsigned int *status)

功能说明

查询SDID标识的NPU状态信息,NPU状态信息决定共享资源的释放方式。

参数说明

参数名称

输入/输出

类型

描述

card_id

输入

int

设备ID,当前实际支持的ID通过dcmi_get_card_num_list接口获取。

device_id

输入

int

芯片ID,通过dcmi_get_device_id_in_card接口获取。取值范围如下:

NPU芯片:[0, device_id_max-1]。

sdid

输入

unsigned int

超节点系统里每个NPU的唯一标识,此处应传入目标NPU的SDID。

status

输出

unsigned int

SDID标识的NPU状态信息,默认为0。

  • 1表示目标NPU状态异常,后续共享资源释放方式为:本端NPU强制释放共享给目标NPU的资源。
  • 0表示目标NPU状态正常,后续共享资源释放方式为:本端NPU协商释放共享给目标NPU的资源。

返回值说明

类型

描述

int

处理结果:

  • 成功:返回0。
  • 失败:返回码请参见返回码

异常处理

无。

约束说明

表1 不同部署场景下的支持情况

物理机场景(裸机)

物理机+普通容器场景

root用户

运行用户组(非root用户)

root用户

N

N

N

注:Y表示支持;N表示不支持;NA表示不涉及,当前未规划此场景。

调用示例

…  
int card_id = 0;
int device_id = 0;
unsigned int sdid = 0;
unsigned int status = 0; 
int ret = dcmi_get_spod_node_status(card_id, device_id, sdid, &status); 
if (ret != 0) {
     //todo:记录日志
     return ret;
} 
…