昇腾社区首页
中文
注册

dcmi_get_extra_statistics_info接口原型

函数原型

int dcmi_get_extra_statistics_info(int card_id, int device_id, int port_id, struct dcmi_extra_statistics_info *info)

功能说明

查询网口扩展统计信息,支持查询端口链路状态以下计数:包含pcs err、纠前误码统计、纠后误码统计、未纠正误码统计。

参数说明

参数名称

输入/输出

类型

描述

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]。

port_id

输入

int

NPU设备的网口端口号,当前仅支持配置0。

info

输出

struct dcmi_extra_statistics_info *

struct dcmi_extra_statistics_info {

unsigned long long cw_total_cnt; //码字总数

unsigned long long cw_before_correct_cnt; //码字纠前误码统计

unsigned long long cw_correct_cnt; //码字可纠误码统计

unsigned long long cw_uncorrect_cnt; //码字不可纠误码统计

unsigned long long cw_bad_cnt; //cw_bad事件次数

unsigned long long trans_total_bit; //传输的总bit数

unsigned long long cw_total_correct_bit; //码字可纠的总bit数

unsigned long long rx_full_drop_cnt; //接收方向buffer满后的丢包计数

unsigned long long pcs_err_cnt; //pcs层错误块计数

unsigned long long rx_send_app_good_pkts; //发送到APP侧的好帧总数,不包括fc-consumed-error帧。fc-consumed-error:MAC发送标记了abort的流控帧

unsigned long long rx_send_app_bad_pkts; //发送到APP侧的坏帧或fc-consumed-error帧总数

double correcting_bit_rate; //可纠比特率

};

返回值说明

类型

描述

int

处理结果:

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

异常处理

约束说明

表1 部署场景

Linux物理机

Linux物理机容器

root用户

运行用户组(非root用户)

root用户

N

N

N

调用示例

…  
int ret = 0; 
int card_id = 0; 
int device_id = 0; 
int port_id = 0;
struct dcmi_extra_statistics_info info = {0}; 
ret = dcmi_get_extra_statistics_info (card_id, device_id, port_id, &info); 
if (ret != 0){
     //todo:记录日志
     return ret;
} 
…