dcmi_get_device_network_health接口原型

函数原型

int dcmi_get_device_network_health(int card_id, int device_id, enum dcmi_rdfx_detect_result *result)

功能说明

查询RoCE网卡的IP地址的连通状态。

参数说明

参数名称	输入/输出	类型	描述
card_id	输入	int	指定NPU管理单元的ID，当前实际支持的ID通过dcmi_get_card_list接口获取。
device_id	输入	int	指定设备编号，通过dcmi_get_device_id_in_card接口获取。取值范围如下： NPU芯片：[0, device_id_max-1]。
result	输出	enum dcmi_rdfx_detect_result *	查询RoCE网卡的IP地址的连通状态，内容定义为： enum dcmi_rdfx_detect_result { DCMI_RDFX_DETECT_OK = 0, // 网络健康状态正常 DCMI_RDFX_DETECT_SOCK_FAIL = 1, // 网络套接字创建失败 DCMI_RDFX_DETECT_RECV_TIMEOUT = 2, // 网口收包超时 DCMI_RDFX_DETECT_UNREACH = 3, // 侦测ip地址不可达 DCMI_RDFX_DETECT_TIME_EXCEEDED = 4, // 发送侦测报文执行超时 DCMI_RDFX_DETECT_FAULT = 5, // 发送侦测报文失败 DCMI_RDFX_DETECT_INIT = 6, // 侦测任务初始化中 DCMI_RDFX_DETECT_THREAD_ERR = 7, // 侦测任务创建失败 DCMI_RDFX_DETECT_IP_SET = 8, // 正在设置侦测ip地址 DCMI_RDFX_DETECT_MAX = 0xFF };

参数名称

输入/输出

类型

描述

card_id

输入

int

指定NPU管理单元的ID，当前实际支持的ID通过dcmi_get_card_list接口获取。

device_id

输入

int

指定设备编号，通过dcmi_get_device_id_in_card接口获取。取值范围如下：

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

result

输出

enum dcmi_rdfx_detect_result *

查询RoCE网卡的IP地址的连通状态，内容定义为：

enum dcmi_rdfx_detect_result {

DCMI_RDFX_DETECT_OK = 0, // 网络健康状态正常

DCMI_RDFX_DETECT_SOCK_FAIL = 1, // 网络套接字创建失败

DCMI_RDFX_DETECT_RECV_TIMEOUT = 2, // 网口收包超时

DCMI_RDFX_DETECT_UNREACH = 3, // 侦测ip地址不可达

DCMI_RDFX_DETECT_TIME_EXCEEDED = 4, // 发送侦测报文执行超时

DCMI_RDFX_DETECT_FAULT = 5, // 发送侦测报文失败

DCMI_RDFX_DETECT_INIT = 6, // 侦测任务初始化中

DCMI_RDFX_DETECT_THREAD_ERR = 7, // 侦测任务创建失败

DCMI_RDFX_DETECT_IP_SET = 8, // 正在设置侦测ip地址

DCMI_RDFX_DETECT_MAX = 0xFF

};

返回值

类型	描述
int	处理结果：成功：返回0。失败：返回码请参见返回码。

异常处理

无。

约束说明

表1 部署场景
Linux物理机		Linux物理机容器
root用户	运行用户组（非root用户）	root用户
N	N	N

调用示例

… 
int ret = 0;
enum dcmi_rdfx_detect_result health = DCMI_RDFX_DETECT_MAX;
int card_id = 0;
int device_id = 0;
ret = dcmi_get_device_network_health(card_id, device_id, &health);
…