cann-robot【PR】: 修改docs/zh/dev_guide下面的md文件名以及修改api_ref的部分接口描述

2. 初始化与去初始化

本章节描述 CANN Runtime 的初始化与去初始化接口，包括 ACL 环境的初始化、反初始化及相关回调注册。

aclError aclInit(const char *configPath)：初始化函数。
aclError aclFinalize()：去初始化函数，用于释放进程内acl接口使用的相关资源。
aclError aclFinalizeReference(uint64_t *refCount)：去初始化函数，用于释放进程内acl接口使用的相关资源。
aclError aclInitCallbackRegister(aclRegisterCallbackType type, aclInitCallbackFunc cbFunc, void *userData)：注册初始化回调函数。
aclError aclInitCallbackUnRegister(aclRegisterCallbackType type, aclInitCallbackFunc cbFunc)：若不需要触发回调函数的调用，可调用本接口取消注册回调函数。
aclError aclFinalizeCallbackRegister(aclRegisterCallbackType type, aclFinalizeCallbackFunc cbFunc, void *userData)：注册去初始化回调函数。
aclError aclFinalizeCallbackUnRegister(aclRegisterCallbackType type, aclFinalizeCallbackFunc cbFunc)：若不需要触发回调函数的调用，可调用本接口取消注册回调函数。

aclInit

aclError aclInit(const char *configPath)

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：支持

功能说明

初始化函数。

使用acl接口开发应用时，必须先调用aclInit接口，否则可能会导致后续系统内部资源初始化出错，进而导致其它业务异常。

参数说明

参数名	输入/输出	说明
configPath	输入	配置文件所在路径（包含文件名）的指针。配置文件内容为json格式（json文件内的“{”的层级最多为10，“[”的层级最多为10）。初始化时，可通过该配置文件配置开启Dump、配置Profiling采集信息等功能，详细描述请参见下文各功能配置示例中的描述。如果默认配置已满足需求，无需修改，可向aclInit接口中传入NULL，或者可将配置文件配置为空json串（即配置文件中只有{}）。

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

约束说明

一个进程内支持多次调用aclInit接口初始化，但需调用aclFinalize或aclFinalizeReference接口去初始化，支持以下场景：
- 每次调用aclInit接口时，配置必须保持一致，否则仅首次调用的配置有效，后续调用aclInit接口可能会导致报错或配置无效。
- 为兼容旧版本，重复调用aclInit接口会返回ACL_ERROR_REPEAT_INITIALIZE错误码，您可以忽略该错误继续处理业务。
- 若调用aclInit、aclFinalize接口分别实现初始化、去初始化，支持重复初始化、去初始化，时序上仅支持顺序调用，接口调用时序如下：
```
aclInit-->业务处理-->aclFinalize-->aclInit-->业务处理-->aclFinalize
```
  该场景下，如果调用多次aclInit接口后，再去初始化，仅需调用一次aclFinalize接口，将aclInit接口的引用计数直接清零。
- 若调用aclInit、aclFinalizeReference接口分别实现初始化、去初始化，则需成对调用aclInit、aclFinalizeReference接口。
  
  因为aclFinalizeReference接口内部涉及引用计数的实现，aclInit接口每被调用一次，则引用计数加一，aclFinalizeReference接口每被调用一次，则该引用计数减一，当引用计数减到0时，才会真正去初始化。
  
  支持重复初始化、去初始化，时序上支持顺序调用，也支持并发调用，接口调用时序如下：
  - 顺序调用时序图如下：
  - 并发调用时序图如下：

一个进程内支持多次调用aclInit接口初始化，但要求aclInit接口与aclFinalize去初始化接口数量匹配，支持以下场景：
- 成对调用aclInit、aclFinalize接口，分别实现初始化、去初始化，在每对aclInit和aclFinalize中正常处理业务，同时每次aclInit接口中的json配置都能生效：
```
aclInit-->业务处理-->aclFinalize-->aclInit-->业务处理-->aclFinalize
```
- 连续调用N次aclInit接口初始化，这时也需连续调用N次aclFinalize接口才能真正去初始化，且只有第一次aclInit接口中的json配置生效：
```
aclInit-->aclInit-->业务处理-->aclFinalize-->aclFinalize
```
  该场景下，若在aclInit接口前调用1次或多次aclFinalize接口，此时不会触发去初始化流程；若调用N次aclInit接口后，调用aclFinalize接口的次数大于N，则多余的aclFinalize接口也不会触发去初始化流程。
- 多线程场景推荐如下使用方式，否则可能导致业务异常：
  - 主线程调用aclInit和aclFinalize、子线程调模型推理等业务处理，主线程等待子线程的业务处理结束再调用aclFinalize：
  - 各子线程均成对调aclInit和aclFinalize：
模型推理（同步）场景下，若开启Dump功能，只支持在一个进程中对一个或多个模型执行Dump操作，由于资源限制，其它进程中不建议启动推理程序，否则可能造成Dump异常。

若对多个模型执行Dump操作，多个模型必须串行；

建议单线程内对模型执行Dump操作，否则可能出现Dump数据文件路径中的序号（即data_index）不准确，导致Dump数据存放的目录异常。
模型推理（异步）场景下，若开启Dump功能，建议一次异步推理、一次流同步，否则可能出现Dump数据文件路径中的序号（即data_index）不准确，导致Dump数据存放的目录异常。

模型Dump配置、单算子Dump配置

模型Dump配置（用于导出模型中每一层算子输入和输出数据）、单算子Dump配置（用于导出单个算子的输入和输出数据），导出的数据用于与指定模型或算子进行比对，定位精度问题，具体比对方法请参见《精度调试工具用户指南》。默认不启用该Dump配置。

通过本接口启用Dump配置，需通过dump_path参数配置保存Dump数据的路径。

模型Dump配置示例如下：

{                                                                                            
    "dump":{
        "dump_list":[                                                                        
            {    "model_name":"ResNet-101"
            },
            {                                                                                
                "model_name":"ResNet-50",
                "layer":[
                      "conv1conv1_relu",
                      "res2a_branch2ares2a_branch2a_relu",
                      "res2a_branch1",
                      "pool1"
                ] 
            }  
        ],  
        "dump_path":"/home/output",
                "dump_mode":"output",
        "dump_op_switch":"off",
                "dump_data":"tensor"
    }                                                                                        
}

单算子调用场景下，Dump配置示例如下：

{
    "dump":{
        "dump_path":"/home/output",
        "dump_list":[{}], 
    "dump_op_switch":"on",
        "dump_data":"tensor"
    }
}

IPV350只支持模型Dump配置，不支持单算子Dump配置。若开启模型Dump配置、且在模型加载时加载exeom文件时，则dbg文件要存放在json配置文件中dump_path参数指定的路径下，才可以生成dump数据文件，用于后续的精度问题定位及分析。exeom文件以及dbg文件是在模型转换时生成，请参见《ATC离线模型编译工具》中的“参数说明 > 基础功能参数 > 总体选项 > --mode”。

异常算子Dump配置

异常算子Dump配置，用于导出异常算子的输入输出数据、workspace信息、Tiling信息等。导出的数据用于分析AI Core Error问题，默认不启用该Dump配置。

关于AI Core Error问题的信息收集及定义，详细说明请参见《故障处理》。

通过配置dump_scene参数值开启异常算子Dump功能，配置文件中的示例内容如下，表示开启轻量化的exception dump：

{
    "dump":{
        "dump_path":"output",
        "dump_scene":"aic_err_brief_dump"
    }
}

详细配置说明及约束如下：

dump_scene参数支持如下取值：
- aic_err_brief_dump：表示轻量化exception dump，用于导出AI Core错误算子的输入&输出、workspace数据。
- aic_err_norm_dump：表示普通exception dump，在轻量化exception dump基础上，还会导出Shape、Data Type、Format以及属性信息。
- aic_err_detail_dump：在轻量化exception dump基础上，还会导出AI Core的内部存储、寄存器以及调用栈信息。
  
  配置该选项时，有以下注意事项：
  - 该选项仅支持以下型号，且需配套25.0.RC1或更高版本的驱动才可以使用：
    
    Atlas A3 训练系列产品/Atlas A3 推理系列产品
    
    Atlas A2 训练系列产品/Atlas A2 推理系列产品
    
    您可以单击Link，在“固件与驱动”页面下载Ascend HDK 25.0.RC1或更高版本的驱动安装包，并参考相应版本的文档进行安装、升级。
  - 导出dump文件过程中，会暂停问题算子所在的AI Core，因此可能会影响Device上其它业务进程的正常执行，导出dump文件后，AI Core会自动恢复。因此，多个Host侧用户业务进程指定同一个Device的场景下，不建议使用aic_err_detail_dump选项。
  - 导出dump文件后，会强制退出Host侧用户业务进程，强制退出过程中的报错可不作为AI Core问题分析的输入。
  - 配置aic_err_detail_dump选项后，如果生成了dump文件，但不是*.core文件，则表示aic_err_detail_dump对应的功能没有使能成功，系统自动切换为按aic_err_brief_dump选项dump。
- lite_exception：表示轻量化exception dump，为了兼容旧版本，效果等同于aic_err_brief_dump。
dump_path是可选参数，表示导出dump文件的存储路径。

dump文件存储路径的优先级如下：NPU_COLLECT_PATH环境变量 > ASCEND_WORK_PATH环境变量 > 配置文件中的dump_path > 应用程序的当前执行目录，环境变量的详细描述请参见《环境变量参考》。

若需查看导出的dump文件内容，请参见《故障处理》中的“故障定位工具 > msaicerr工具使用指导 > 解析Dump文件”章节。

若将dump_scene参数设置为aic_err_detail_dump时，需使用msDebug工具查看导出的dump文件内容，详细方法请参见《算子开发工具用户指南》。

异常算子Dump配置，不能与模型Dump配置或单算子Dump配置同时开启。

溢出算子Dump配置

溢出算子Dump配置，用于导出模型中溢出算子的输入和输出数据。导出的数据用于分析溢出原因，定位模型精度的问题。默认不启用该Dump配置。

将dump_debug参数设置为on表示开启溢出算子配置，配置文件中的示例内容如下：

{
    "dump":{
        "dump_path":"output",
        "dump_debug":"on"
    }
}

详细配置说明及约束如下：

不配置dump_debug或将dump_debug配置为off表示不开启溢出算子配置。
若开启溢出算子配置，则dump_path必须配置，表示导出dump文件的存储路径。

获取导出的数据文件后，文件的解析请参见《精度调试工具用户指南》。

dump_path支持配置绝对路径或相对路径：
- 绝对路径配置以“/“开头，例如：/home。
- 相对路径配置直接以目录名开始，例如：output。
溢出算子Dump配置，不能与模型Dump配置或单算子Dump配置同时开启，否则会返回报错。
仅支持采集AI Core算子的溢出数据。

算子Dump Watch模式配置

算子Dump Watch模式配置，用于开启指定算子输出数据的观察模式。在定位部分算子精度问题且已排除算子本身的计算问题后，若怀疑被其它算子踩踏内存导致精度问题，可开启Dump Watch模式。默认不开启Dump Watch模式。

将dump_scene参数设置为watcher，开启算子Dump Watch模式，配置文件中的示例内容如下，配置效果为：（1）当执行完A算子、B算子时，会把C算子和D算子的输出Dump出来；（2）当执行完C算子、D算子时，也会把C算子和D算子的输出Dump出来。将（1）、（2）中的C算子、D算子的Dump文件进行比较，用于排查A算子、B算子是否会踩踏C算子、D算子的输出内存。

{
    "dump":{
        "dump_list":[
            {
                "layer":["A", "B"],
                "watcher_nodes":["C", "D"]
            }
        ],
        "dump_path":"/home/",
        "dump_mode":"output",
        "dump_level":"op",
        "dump_scene":"watcher"
    }
}

详细配置说明及约束如下：

若开启算子Dump Watch模式，则不支持同时开启溢出算子Dump（配置dump_debug参数）或开启单算子模型Dump（配置dump_op_switch参数），否则报错。该模式在单算子API Dump场景下不生效。
在dump_list中，通过layer参数配置可能踩踏其它算子内存的算子名称，通过watcher_nodes参数配置可能被其它算子踩踏输出内存导致精度有问题的算子名称。
- 若不指定layer，则模型内所有支持Dump的算子在执行后，都会将watcher_nodes中配置的算子的输出Dump出来。
- layer和watcher_nodes处配置的算子都必须是静态图、静态子图中的算子，否则不生效。
- 若layer和watcher_nodes处配置的算子名称相同，或者layer处配置的是集合通信类算子（算子类型以Hcom开头，例如HcomAllReduce），则只导出watcher_nodes中所配置算子的dump文件。
- 对于融合算子，watcher_nodes处配置的算子名称必须是融合后的算子名称，若配置融合前的算子名称，则不导出dump文件。
- dump_list内暂不支持配置model_name。
开启算子Dump Watch模式，则dump_path必须配置，表示导出dump文件的存储路径。

此处收集的dump文件无法通过文本工具直接查看其内容，若需查看dump文件内容，先将dump文件转换为numpy格式文件后，再通过Python查看numpy格式文件，详细转换步骤请参见《精度调试工具用户指南》。

dump_path支持配置绝对路径或相对路径：
- 绝对路径配置以“/“开头，例如：/home。
- 相对路径配置直接以目录名开始，例如：output。
通过dump_mode参数控制导出watcher_nodes中所配置算子的哪部分数据，当前仅支持配置为output。
通过dump_level设置dump数据级别，取值如下。默认配置下，dump数据文件会比较多，例如有一些aclnn开头的dump文件，若用户对dump性能有要求或内存资源有限时，则可以将该参数设置为op级别，以便提升dump性能、精简dump数据文件数量。
- op：按算子级别dump数据。算子是一个运算逻辑的表示（如加减乘除运算）。
- kernel：按kernel级别dump数据。
- all：默认值，op和kernel级别的数据都dump。kernel是运算逻辑真正进行计算处理的实现，需要分配具体的计算设备完成计算。

算子Kernel调测信息Dump配置

算子Kernel调测信息Dump配置，用于导出Ascend C算子Kernel的调测信息，便于定位算子问题。默认不启用该Dump配置。

仅如下型号支持该配置：

Ascend 950PR/Ascend 950DT

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas A2 训练系列产品/Atlas A2 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

配置dump_kernel_data参数开启算子Kernel调测信息Dump功能，配置文件中的示例如下：

{
    "dump":{
        "dump_kernel_data":"printf,assert",
        "dump_path":"/home/"
    }
}

详细配置说明及约束如下：

dump_kernel_data：指定导出数据的类型，支持配置多个类型，用英文逗号隔开。如果未配置该字段，但启用了模型Dump配置、单算子Dump配置，则默认按all导出调测信息。

当前支持如下类型：
- all：导出以下所有类型调测的输出数据。
- printf：导出通过AscendC::printf调测的输出数据。
- tensor：导出通过AscendC::DumpTensor调测的输出数据。
- assert：导出通过assert/ascendc_assert调测的输出数据。
- timestamp：导出通过AscendC::PrintTimeStamp调测的输出数据。
dump_path：启用算子Kernel调测信息Dump功能时，dump_path必须配置，表示导出Dump文件的存储路径，支持配置绝对路径或相对路径。

Dump文件存储路径的优先级如下：ASCEND_DUMP_PATH环境变量 > ASCEND_WORK_PATH环境变量 > 配置文件中的dump_path，环境变量的详细描述请参见《环境变量参考》。

导出的Dump文件无法通过文本工具直接查看其内容，若需查看，需使用show_kernel_debug_data工具将调测信息解析为可读格式，工具使用指导请参见《Ascend C算子开发指南》。

Profiling采集信息配置

Profiling采集信息配置，配置示例、说明及约束请参见《性能调优工具用户指南》。默认不启用Profiling采集信息配置。

建议不要同时配置Dump信息和Profiling采集信息，否则Dump操作会影响系统性能，导致Profiling采集的性能数据指标不准确。

算子缓存信息老化配置

IPV350不支持算子缓存信息老化配置。

算子缓存信息老化配置，通过单算子模型方式执行单个算子时（aclopUpdateParams接口执行单算子除外），为节约内存和平衡调用性能，可通过max_opqueue_num参数配置“算子类型-单算子模型”映射队列的最大长度，如果长度达到最大，则会先删除长期未使用的映射信息以及缓存中的单算子模型，再加载最新的映射信息以及对应的单算子模型。如果不配置映射队列的最大长度，则默认最大长度为20000。

单算子模型执行是指基于图IR执行算子，先编译算子（例如，使用ATC工具将Ascend IR定义的单算子描述文件编译成算子om模型文件），再调用acl接口加载算子模型（例如aclopSetModelDir接口），最后调用acl接口执行算子（例如aclopExecuteV2接口）。

通过max_opqueue_num参数配置“算子类型-单算子模型”映射队列的最大长度，实现算子缓存信息老化，配置文件中的示例内容如下：

{
        "max_opqueue_num": "10000"
}

错误信息上报模式配置

**错误信息上报模式配置，**用于控制aclGetRecentErrMsg接口按进程或线程级别获取错误信息，默认按线程级别。

err_msg_mode参数取值范围：0为默认值，表示按线程级别获取错误信息；1表示按进程级别获取错误信息。

配置文件中的示例内容如下：

{
        "err_msg_mode": "1"
}

默认Device配置示例

默认Device配置（用于配置默认的计算设备）。若同时通过aclrtSetDevice接口指定Device，则aclrtSetDevice接口优先级高。如果用户开启默认Device功能后，若需要显式创建Context，则需要调用aclrtSetDevice，否则可能会导致业务异常。

default_device参数处设置Device ID，Device ID可设置为0或十进制正整数，用户可调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量-1)]。

配置文件中的示例内容如下：

{
    "defaultDevice":{
        "default_device":"0"
    }
}

AI Core栈空间大小配置示例

AI Core栈空间大小配置，用于控制进程中Kernel执行时为每个AI Core分配的栈空间大小，默认为32K字节。

Ascend 950PR/Ascend 950DT支持该配置，在编译AI Core算子时，无需打开O0开关。

Atlas A3 训练系列产品/Atlas A3 推理系列产品、Atlas A2 训练系列产品/Atlas A2 推理系列产品支持该配置，但在编译AI Core算子时，只有打开O0开关，此处配置的AI Core栈空间大小才有效。

Atlas 200I/500 A2 推理产品支持该配置，但在编译AI Core算子时，只有打开O0开关，此处配置的AI Core栈空间大小才有效。

aicore_stack_size参数处设置栈空间大小，单位Byte，取值有以下要求：

aicore_stack_size是16K的整数倍，若传入aicore_stack_size不是16K的整数倍，则会向上取整，确保其为16K的整数倍。
aicore_stack_size最小值为32K，若传入的aicore_stack_size小于32K，则按默认配置32K处理。
各产品的aicore_stack_size最大值如下：

在Ascend 950PR/Ascend 950DT上，aicore_stack_size最大值为128K。

在Atlas A3 训练系列产品/Atlas A3 推理系列产品、Atlas A2 训练系列产品/Atlas A2 推理系列产品上，aicore_stack_size最大值为192K。

在Atlas 200I/500 A2 推理产品上，aicore_stack_size最大值为7680K。

配置文件中的示例内容如下：

{
    "StackSize":{
        "aicore_stack_size":32768
    }
}

SIMT算子栈空间大小配置示例

SIMT（Single Instruction Multiple Thread）栈空间大小配置，用于控制每个线程中SIMT算子的栈空间大小以及SIMT算子的分支（Divergence）栈空间大小，单位Byte。

仅Ascend 950PR/Ascend 950DT支持该配置。

simt_stack_size参数处设置SIMT算子每个线程的栈空间大小，单位Byte。默认值为1152Byte。

simt_divergence_stack_size参数处设置SIMT算子的分支（Divergence）栈空间大小，单位Byte。默认值为1024Byte。

simt_stack_size和simt_divergence_stack_size的取值都必须是128的整数倍，如果传入的不是128的整数倍，则接口内部会自动向上取整，确保其为128的整数倍。

配置文件中的示例内容如下：

{
  "StackSize": {      
    "simt_stack_size": 1024,            
    "simt_divergence_stack_size": 512   
  }
}

SIMT Printf维测空间大小配置示例

SIMT（Single Instruction Multiple Thread）Printf维测空间大小配置，用于控制SIMT算子可以Printf打印的空间大小，单位Byte。

仅Ascend 950PR/Ascend 950DT支持该配置。

simt_printf_fifo_size参数处设置SIMT算子Printf维测空间大小，单位Byte。其取值都必须是8的整数倍，如果传入的不是8的整数倍，则接口内部会自动向上取整，确保其为8的整数倍。

simt_printf_fifo_size配置默认值2MB，最小值是1MB，最大值64MB。

配置文件中的示例内容如下：

{
  "simt_printf_fifo_size": 1048576
}

SIMD Printf维测空间大小配置示例

SIMD（Single Instruction Multiple Data）Printf维测空间大小配置，用于控制每个Core上SIMD算子可以Printf打印的空间大小，单位Byte。仅如下型号支持该配置：

仅Ascend 950PR/Ascend 950DT、Atlas A3 训练系列产品/Atlas A3 推理系列产品、Atlas A2 训练系列产品/Atlas A2 推理系列产品支持该配置。

simd_printf_fifo_size_per_core参数处设置SIMD算子Printf维测空间大小，单位Byte。其取值都必须是8的整数倍，如果传入的不是8的整数倍，则接口内部会自动向上取整，确保其为8的整数倍。

simd_printf_fifo_size_per_core配置默认值32KB，最小值是1KB，最大值64MB。

配置文件中的示例内容如下：

{
  "simd_printf_fifo_size_per_core": 1048576
}

aclFinalize

aclError aclFinalize()

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：支持

功能说明

去初始化函数，用于释放进程内acl接口使用的相关资源。

对于涉及Device业务日志回传到Host的场景，本接口默认增加2000ms延时（实际最大延时可达2000ms），以确保ERROR级别和EVENT级别日志完整回传，防止不丢失。您可以将ASCEND_LOG_DEVICE_FLUSH_TIMEOUT环境变量设置为0（命令示例：export ASCEND_LOG_DEVICE_FLUSH_TIMEOUT=0），来取消该默认延时。关于ASCEND_LOG_DEVICE_FLUSH_TIMEOUT环境变量的详细描述请参见《环境变量参考》中的。

参数说明

无

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

约束说明

应用进程退出前，应确保已调用aclFinalize或aclFinalizeReference接口完成去初始化，否则可能会导致异常，例如应用进程退出时有异常报错。

不建议在析构函数中调用aclFinalize或aclFinalizeReference接口，否则在进程退出时可能由于单例析构顺序未知而导致进程异常退出的问题。

aclFinalizeReference

aclError aclFinalizeReference(uint64_t *refCount)

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：不支持

功能说明

去初始化函数，用于释放进程内acl接口使用的相关资源。

aclFinalizeReference接口内部涉及引用计数的实现，aclInit接口每被调用一次，则引用计数加一，aclFinalizeReference接口每被调用一次，则该引用计数减一，当引用计数减到0时，才会真正去初始化。aclFinalize接口与本接口的区别在于，调用aclFinalize接口会将计数清零，直接去初始化。

参数说明

参数名	输入/输出	说明
refCount	输入&输出	返回调用aclFinalizeReference后的引用计数。若不需要获取引用计数，此处可传nullptr。

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

约束说明

应用进程退出前，应确保已调用aclFinalize或aclFinalizeReference接口完成去初始化，否则可能会导致异常，例如应用进程退出时有异常报错。

不建议在析构函数中调用aclFinalize或aclFinalizeReference接口，否则在进程退出时可能由于单例析构顺序未知而导致进程异常退出的问题。

aclInitCallbackRegister

aclError aclInitCallbackRegister(aclRegisterCallbackType type, aclInitCallbackFunc cbFunc, void *userData)

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：不支持

功能说明

注册初始化回调函数。

若在aclInit接口之前调用本接口，则会在初始化时触发回调函数的调用；若在aclInit接口之后调用本接口，则会在注册时立即触发回调函数的调用。

参数说明

参数名	输入/输出	说明
type	输入	注册类型，按照不同的功能区分，请参见aclRegisterCallbackType。
cbFunc	输入	初始化回调函数。回调函数的函数原型为： typedef aclError (aclInitCallbackFunc)(const charconfigStr, size_t len, void *userData); configStr跟aclInit接口中的json文件内容保持一致；len表示json文件内容的长度，单位Byte。
userData	输入	待传递给回调函数的用户数据的指针。

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclInitCallbackUnRegister

aclError aclInitCallbackUnRegister(aclRegisterCallbackType type, aclInitCallbackFunc cbFunc)

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：不支持

功能说明

若不需要触发回调函数的调用，可调用本接口取消注册回调函数。

参数说明

参数名	输入/输出	说明
type	输入	注册类型，按照不同的功能区分，请参见aclRegisterCallbackType。
cbFunc	输入	初始化回调函数。回调函数的函数原型为： typedef aclError (aclInitCallbackFunc)(const charconfigStr, size_t len, void *userData);

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclFinalizeCallbackRegister

aclError aclFinalizeCallbackRegister(aclRegisterCallbackType type, aclFinalizeCallbackFunc cbFunc, void *userData)

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：不支持

功能说明

注册去初始化回调函数。

在aclFinalize接口之前调用本接口，在去初始化时触发回调函数的调用。

参数说明

参数名	输入/输出	说明
type	输入	注册类型，按照不同的功能区分，请参见aclRegisterCallbackType。
cbFunc	输入	去初始化回调函数。回调函数定义如下： typedef aclError (aclFinalizeCallbackFunc)(voiduserData);
userData	输入	待传递给回调函数的用户数据的指针。

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclFinalizeCallbackUnRegister

aclError aclFinalizeCallbackUnRegister(aclRegisterCallbackType type, aclFinalizeCallbackFunc cbFunc)

产品支持情况

Ascend 950PR/Ascend 950DT：支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

Atlas 200I/500 A2 推理产品：支持

Atlas 推理系列产品：支持

Atlas 训练系列产品：支持

IPV350：不支持

功能说明

若不需要触发回调函数的调用，可调用本接口取消注册回调函数。

参数说明

参数名	输入/输出	说明
type	输入	注册类型，按照不同的功能区分，请参见aclRegisterCallbackType。
cbFunc	输入	去初始化回调函数。回调函数定义如下： typedef aclError (aclFinalizeCallbackFunc)(voiduserData);

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。