文件	最后提交记录	最后更新时间
common	【PR】: profiling add mstx sample Co-authored-by: WangangYu<2392205247@qq.com> # message auto-generated for no-merge-commit merge: !2083 merge ywg-runtime into master 【PR】: profiling add mstx sample Created-by: MrYudd Commit-by: WangangYu Merged-by: cann-robot Description: # Pull Request ## 描述 profiling 添加mstx 样例 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!2083	3 个月前
CMakeLists.txt	【PR】: profiling add mstx sample Co-authored-by: WangangYu<2392205247@qq.com> # message auto-generated for no-merge-commit merge: !2083 merge ywg-runtime into master 【PR】: profiling add mstx sample Created-by: MrYudd Commit-by: WangangYu Merged-by: cann-robot Description: # Pull Request ## 描述 profiling 添加mstx 样例 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!2083	3 个月前
README.md	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	1 个月前
README_en.md	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	1 个月前
mstx_with_domain.cpp	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	1 个月前
run.sh	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	1 个月前

3_mstx_with_domain

描述

本样例展示 mstx 接口在默认 domain 与自定义 domain 中打点的使用方式，并演示通过 msprof 的 --mstx-domain-include 和 --mstx-domain-exclude 参数控制采集范围。样例源码为当前目录下的 mstx_with_domain.cpp，由 run.sh 完成编译并执行。

产品支持情况

本样例支持以下产品：

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√

编译运行

1.下载样例代码至安装CANN软件的环境，切换到样例目录。

cd ${git_clone_path}/example/5_performance/profiling/3_mstx_with_domain

2.设置环境变量。

# ${install_root} 替换为 CANN 安装根目录，默认安装在`/usr/local/Ascend`目录
source ${install_root}/cann/set_env.sh

3.执行以下命令运行样例。

bash run.sh

msprof采集

如需使用 msprof 采集 mstx 打点数据，可按如下场景执行：

# 采集所有打点数据，包括默认 domain 和自定义 domain
msprof --msproftx=on bash run.sh

# 只采集 default domain 的打点数据
msprof --msproftx=on --mstx-domain-include="default" bash run.sh

# 采集 default domain 之外的打点数据
msprof --msproftx=on --mstx-domain-exclude="default" bash run.sh

--mstx-domain-include 与 --mstx-domain-exclude 参数互斥，不可同时配置。如需指定多个 domain，使用逗号隔开。

CANN RUNTIME API

在本样例中，涉及的关键功能点及其关键接口如下所示：

默认 domain 打点
- 调用 mstxMarkA 接口记录默认 domain 的瞬时事件。
- 调用 mstxRangeStartA 和 mstxRangeEnd 接口记录默认 domain 的范围事件。
自定义 domain 管理与打点
- 调用 mstxDomainCreateA 接口创建自定义 domain。
- 调用 mstxDomainMarkA 接口记录自定义 domain 的瞬时事件。
- 调用 mstxDomainRangeStartA 和 mstxDomainRangeEnd 接口记录自定义 domain 的范围事件。
- 调用 mstxDomainDestroy 接口销毁自定义 domain。

示例输出

[INFO]: AscendHome is set to ...
...
result[0] is: 1.200000
result[1] is: 2.200000
result[2] is: 3.200000
result[3] is: 5.400000
result[4] is: 6.400000
result[5] is: 7.400000
result[6] is: 9.600000
result[7] is: 10.600000