昇腾社区首页
中文
注册
开发者
下载

常用的编译选项

常用的编译选项说明如下,全量的编译选项请参考毕昇编译器用户指南

选项

是否必需

说明

-help

查看帮助。

--npu-arch

编译时指定的昇腾AI处理器架构,取值为dav-<arch-version>, 其中<arch-version>为NPU架构版本号,各产品型号对应的架构版本号请通过表1进行查询。

--npu-soc

编译时指定的昇腾AI处理器型号,npu-soc和npu-arch同时配置时,优先使能npu-arch。

昇腾AI处理器的型号请通过如下方式获取:

  • 针对如下产品型号:在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询,获取Name信息。实际配置值为AscendName,例如Name取值为xxxyy,实际配置值为Ascendxxxyy

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

    Atlas 200I/500 A2 推理产品

    Atlas 推理系列产品

    Atlas 训练系列产品

  • 针对如下产品型号,在安装昇腾AI处理器的服务器执行npu-smi info -t board -i id -c chip_id命令进行查询,获取Chip NameNPU Name信息,实际配置值为Chip Name_NPU Name。例如Chip Name取值为AscendxxxNPU Name取值为1234,实际配置值为Ascendxxx_1234。其中:
    • id:设备id,通过npu-smi info -l命令查出的NPU ID即为设备id。
    • chip_id:芯片id,通过npu-smi info -m命令查出的Chip ID即为芯片id。

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

-x

指定编译语言,指定为asc时表示Ascend C编程语言。

-o <file>

指定输出文件的名称和位置。

-c

编译生成目标文件。

-shared,--shared

编译生成动态链接库。

-lib,--cce-build-static-lib

编译生成静态链接库。编译器会将Device侧的代码进行编译链接,生成Device侧二进制文件,随后将该文件作为Host侧编译的输入进行编译,最后链接生成静态链接库。

-g

编译时增加调试信息。

--sanitizer

编译时增加代码正确性校验信息。使用sanitizer选项时,需要同步添加-g选项。

-fPIC

告知编译器产生位置无关代码。

-O

用于指定编译器的优化级别,当前支持-O3,-O2,-O0。