昇腾社区首页
中文
注册

ReportInnerErrMsg

函数功能

用于上报CANN预定义好的内部错误信息,同时也会上报调用处的一些信息,如文件名、函数名以及行号。

针对该接口,还提供了封装该接口的宏REPORT_INNER_ERR_MSG,宏定义如下:

#define REPORT_INNER_ERR_MSG(error_code, format, ...) \
    (void)ge::ReportInnerErrMsg(__FILE__, __FUNCTION__, __LINE__, (error_code), (format), ##__VA_ARGS__)

函数原型

int32_t ReportInnerErrMsg(const char_t *file_name, const char_t *func, uint32_t line, const char *error_code, const char_t *format, ...)

参数说明

参数名

输入/输出

说明

file_name

输入

文件名,表示用户在哪个文件中调用ReportInnerErrMsg接口,固定配置为__FILE__。

func

输入

函数名,表示用户在哪个函数中调用ReportInnerErrMsg接口,固定配置为__FUNCTION__。

line

输入

行号,表示用户在哪一行中调用ReportInnerErrMsg接口,固定配置为__LINE__。

error_code

输入

CANN预定义好的内部错误。

错误码以6位字符形式体现,例如E19999,其中,第1位表示级别,分为E、W、I,分别表示错误、告警、提示类;第2位表示模块;后4位表示错误码,9000~9999为内部错误码。

CANN预定义好的内部错误在“${INSTALL_DIR}/runtime/conf/error_manager/error_code.json”文件中可查看。${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。若安装的Ascend-cann-toolkit软件包,以root安装举例,则安装后文件存储路径为:/usr/local/Ascend/ascend-toolkit/latest。

format

输入

错误信息。

在调用格式化函数时,format中参数的类型、个数必须与实际参数类型、个数保持一致。

...

输入

format中的可变参数,根据错误信息添加。

返回值