开启全量检测¶

如需启用全量检测，须在算子代码的编译阶段添加相应编译选项并重新编译算子。由于不同算子工程中编译选项的配置位置存在差异，将以模板库场景、内核调用符场景、msOpGen算子工程编译场景和Triton算子调用场景为例分别说明。

1. 模板库场景¶

修改模板库中的examples/CMakeLists.txt文件，新增-g --cce-enable-sanitizer编译选项。

set(BISHENG_COMPILER_OPTIONS -g --cce-enable-sanitizer)

2. 内核调用符场景¶

样例工程代码请参考LAddKernelInvocation代码示例，执行以下命令，下载分支版本的样例代码。
```
git clone https://gitee.com/ascend/samples.git -b 8.0.RC2
cd operator/AddCustomSample/KernelLaunch/AddKernelInvocation
```
[!NOTE] 此样例工程不支持Atlas A3 训练系列产品/Atlas A3 推理系列产品和Atlas 350 加速卡。
进行算子代码编译，需添加以下编译选项：
- -g
- --cce-enable-sanitizer或--sanitizer
编辑样例工程目录下的“cmake/npu/CMakeLists.txt”文件，参考核函数开发和运行验证的完整样例。
```
target_compile_options(${smoke_testcase}_npu PRIVATE
                    -O2
                    -std=c++17
                    --cce-enable-sanitizer
                    -g
)
```
增加--cce-enable-sanitizer或--sanitizer选项代表使能异常检测，两个选项完全等价，可随意使用其一。

增加-g选项使编译器生成定位信息，将会在异常报告输出时打印异常发生的具体位置（文件名、行号以及调用栈等信息）。

[!NOTE] - --cce-enable-sanitizer和-O0同时开启的情况下，需要增加编译选项 --cce-ignore-always-inline=false。 - 添加-g编译选项会在生成的二进制文件中附带调试信息，建议限制带有调试信息的用户程序的访问权限，确保只有授权人员可以访问该二进制文件。 - 增加--cce-enable-sanitizer编译选项生成的算子二进制，需与msSanitizer工具配套使用。不建议单独使用该二进制，单独使用可能会导致不可预见的问题。 - 因llvm-symbolizer开源软件限制，调用栈的异常信息可能会获取失败。此时，用户可再次执行检测命令，就可以获取调用栈的异常信息。 - 目前Atlas 350 加速卡不支持--cce-enable-sanitizer或--sanitizer以及-O0编译选项。如需在kernel侧添加-g编译选项，添加后若算子中存在异常信息，则工具会展示异常信息对应的调用栈信息。

链接阶段需增加target_link_options选项。

编辑样例工程目录下的“cmake/npu/CMakeLists.txt”文件。

target_link_options(${smoke_testcase}_npu PRIVATE
    --cce-fatobj-link
    --cce-enable-sanitizer
)

编辑样例工程目录下的“cmake/Modules/CMakeCCEInformation.cmake”文件，增加${_CMAKE_COMPILE_AS_CCE_FLAG}链接选项。

if(NOT CMAKE_CCE_LINK_EXECUTABLE)
set(CMAKE_CCE_LINK_EXECUTABLE
    "<CMAKE_CCE_COMPILER> ${CMAKE_LIBRARY_CREATE_CCE_FLAGS} ${_CMAKE_COMPILE_AS_CCE_FLAG} <FLAGS> <CMAKE_CCE_LINK_FLAGS> <LINK_FLAGS> <OBJECTS> -o <TARGET> <LINK_LIBRARIES>${__IMPLICIT_LINKS}")
endif()

启用msSanitizer检测工具时，需要加载NPU侧可执行文件___npu，该文件的获取可参考《Ascend C算子开发指南》中的“Kernel直调算子开发 >Kernel直调”章节。

3. msOpGen算子工程编译场景¶

单击AddCustom代码示例，在${git_clone_path}/samples/operator/ascendc/0_introduction/1_add_frameworklaunch目录下运行install.sh脚本，生成自定义算子工程。
[!NOTE] 下载代码样例时，需执行以下命令指定分支版本。
```
git clone https://gitee.com/ascend/samples.git -b master
```
```
bash install.sh -v Ascendxxxyy    # xxxyy为用户实际使用的具体芯片类型
```
切换至自定义算子工程目录。
```
cd CustomOp
```
编辑样例工程目录下的“op_kernel/CMakeLists.txt”文件，在编译选项中添加-sanitizer选项，具体请参考《MindStudio Ops Generator工具用户指南》中的“算子编译部署>支持自定义编译选项”章节。

add_ops_compile_options(ALL OPTIONS -sanitizer)

4. Triton算子调用场景¶

Triton算子采用Python语言进行开发，并且采用即时编译（JIT）方式来编译算子Kernel。在执行算子脚本前，需要配置以下环境变量支持全量检测。

export TRITON_ENABLE_SANITIZER=1

5. 验证与后续步骤¶

完成上述编译选项配置后：

重新编译算子，确认编译过程无报错。
使用 msSanitizer 工具拉起算子进行检测，具体用法请参见《MindStudio Sanitizer 使用指南》。
若检测报告中的文件名和行号显示异常，请参见《MindStudio Sanitizer 常见问题》。