Skip to main content

aclSetCompileopt

aclFinalize

函数功能

AscendCL去初始化函数,用于释放进程内的AscendCL相关资源,同步接口。

约束说明

应用的进程退出前,应显式调用该接口实现AscendCL去初始化,否则可能会导致异常,例如应用进程退出时有异常报错。

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

函数原型

aclError aclFinalize()

参数说明

返回值说明

返回0表示成功,返回其它值表示失败。

参考资源

接口调用示例,参见AscendCL初始化与去初始化

父主题: 系统配置

aclrtGetVersion

函数功能

查询接口版本号,AscendCL接口版本号命名采用:A.B.C模式,其中,A表示有不兼容修改,B表示新增接口,C表示bug修复。同步接口。

函数原型

aclError aclrtGetVersion(int32_t *majorVersion, int32_t *minorVersion, int32_t *patchVersion)

参数说明

参数名输入/输出说明
majorVersion输出主版本号的指针,从1开始,如果出现接口的不兼容变更时,加1。
minorVersion输出次版本号的指针,从0开始,按照迭代周期,有新增接口时加1。
patchVersion输出补丁版本号的指针,从0开始,表示本版本仅仅解决了问题,在majorVersion、minorVersion不变的情况下加1;但majorVersion、minorVersion增加的时候,patchVersion一般为0。

返回值说明

返回0表示成功,返回其它值表示失败。

父主题: 系统配置

aclSetCompileopt

函数功能

用户可调用本接口设置对应的编译选项,该选项为进程级全局共享,算子或模型开始编译时,以当前的编译选项为准,一次编译过程中不会变更。同步接口。

使用场景:用户可以在调用aclopCompile接口编译算子或aclopCompileAndExecute接口编译执行算子前,调用本接口设置编译选项。

函数原型

aclError aclSetCompileopt(****aclCompileOpt opt, const char *value)

参数说明

参数名输入/输出说明
opt输入编译选项。
value输入编译选项具体值的指针。

返回值说明

返回0表示成功,返回其它值表示失败。

父主题: 系统配置

aclGetCompileopt

函数功能

用户可调用本接口获取编译选项的值。同步接口。

使用场景:用户可以调用本接口获取当前编译选项的值,在调用aclSetCompileopt前,本接口返回的是各编译选项的默认值;在调用aclSetCompileopt后,本接口返回的是用户设置的值。

函数原型

aclError aclGetCompileopt(****aclCompileOpt opt, char *value, size_t length)

参数说明

参数名输入/输出说明
opt输入编译选项。
value输出存放编译选项值的内存的指针。 用户在调用本前需要申请一块内存来保存编译选项的值,内存大小可以通过aclGetCompileoptSize获得。
length输入value指向内存的大小,单位:Byte。

返回值说明

返回0表示成功,返回其它值表示失败。

父主题: 系统配置

aclGetCompileoptSize

函数功能

用户可调用本接口获取存放编译选项值的内存大小。同步接口。

使用场景:用户在调用aclGetCompileopt前需要申请一块内存来保存编译选项的值,内存大小可以通过调用本接口获得。

函数原型

size_t aclGetCompileoptSize(aclCompileOpt opt)

参数说明

参数名输入/输出说明
opt输入编译选项。

返回值说明

返回存放该编译选项值的内存大小,单位:Byte。

父主题: 系统配置

aclrtGetSocName

函数功能

查询当前运行环境的芯片版本。同步接口。

函数原型

const char *aclrtGetSocName()

参数说明

返回值说明

返回芯片版本字符串的指针。如果通过该接口获取芯片版本失败,则返回空指针。

父主题: 系统配置

在线提单