已合并
【PR】:【9.1.0】docs: aclrtDevicePeerAccessStatus资料优化 #3417
【PR】:【9.1.0】docs: aclrtDevicePeerAccessStatus资料优化 #3417
已合并
贾绍扬创建于 7月6日
贾绍扬成员
7月6日

Pull Request

描述

docs: 补充PeerAccessStatus状态说明

变更类型

请选择本次引入的变更类型:

关联的Issue

如何测试

描述测试此变更的步骤和前提条件:
1.
2.

核对清单

其他信息

在此添加任何其他关于本次 PR 的说明。

likedislike
Pull Request已成功合入, 合并人@CANN-robot
(感谢 贾绍扬 的贡献)
贾绍扬成员
7月6日 添加了label:enhancement
贾绍扬成员
7月6日 创建了 pull request,commit 6462125b
CANN-robotCANN-robot成员
7月6日 添加了label:cann-cla/yes
CANN-robot
CANN-robot成员
7月6日 评论:

CLA Signature Pass

jia_shaoyang, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
CANN-robot
CANN-robot成员
7月6日 评论:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here
You can get sig-info at here


PR Approval Progress

Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
** gcw_kUomxQ2l, yanmingxiang (2/2) gcw_kUomxQ2l (1/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

jia_shaoyang, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
贾绍扬成员
7月6日 评论:

/compile

likedislike
贾绍扬成员
7月6日 update merge request[project id: 8810053, iid: 3417, commit_id: 88ac6d178d5e7dc650c6f03edac2d25c0e33087e] virtual merging success
CANN-robotCANN-robot成员
7月6日 将wangtao43,zhangpengpeng8,yanmingxiang,Reyn52166,ykl999,houyanbao,gcw_kUomxQ2l,Andy-lb,tingwood设为评审人
CANN-robotCANN-robot成员
7月6日 将gcw_kUomxQ2l,Andy-lb设为审查人
贾绍扬成员
7月6日 修改标题为 “【PR】:【9.1.0】docs: 补充PeerAccessStatus状态说明”,原标题为“【PR】: docs: 补充PeerAccessStatus状态说明”
CANN-robotCANN-robot成员
7月6日 添加了label:ci-pipeline-running
CANN-robot
CANN-robot成员
7月6日 评论:

流水线任务触发成功
任务链接 [b2f686296cc24a5e859521a1d6b5798d][流水线指导]

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
UT_Test_acl ✅ SUCCESS >>>>>
UT_Test_rts_v201 ✅ SUCCESS >>>>>
UT_Test_rts_c ✅ SUCCESS >>>>>
UT_Test_rts_david ✅ SUCCESS >>>>>
UT_Test_rts_910b ✅ SUCCESS >>>>>
UT_Test_rts_common ✅ SUCCESS >>>>>
UT_Test_platform ✅ SUCCESS >>>>>
UT_Test_qs ✅ SUCCESS >>>>>
UT_Test_aicpusd ✅ SUCCESS >>>>>
UT_Test_tsd ✅ SUCCESS >>>>>
UT_Test_error_manager ✅ SUCCESS >>>>>
UT_Test_slog ✅ SUCCESS >>>>>
UT_Test_atrace ✅ SUCCESS >>>>>
UT_Test_adump ✅ SUCCESS >>>>>
UT_Test_mmpa ✅ SUCCESS >>>>>
PreSmoke_A900_npupool ✅ SUCCESS >>>>>
UT_Test_msprof ✅ SUCCESS >>>>>
UT_Test_rts_report ✅ SUCCESS >>>>>
UT_Test_msprof_report ✅ SUCCESS

[2026-07-06 10:18:12]    CI执行结束

likedislike
CANN-robot
CANN-robot成员
7月6日 评论:

流水线任务触发成功
任务链接 [22b2fdeffe2f4ccc81c53d6499709a33][流水线指导]

任务名称状态日志下载链接
codecheck ✅ SUCCESS >>>>>
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_Check_Pr ✅ SUCCESS
codecheck_style ✅ SUCCESS >>>>>
codecheck_precommit ✅ SUCCESS >>>>> >>>>>
StaticCheck_codespell_check ✅ SUCCESS
StaticCheck_link_validity_check ✅ SUCCESS
StaticCheck_resource_existence_check ✅ SUCCESS
StaticCheck_tag_closed_check ✅ SUCCESS
StaticCheck_markdownlint ✅ SUCCESS

[2026-07-06 10:15:46]    CI执行结束

likedislike
CANN-robotCANN-robot成员
7月6日 删除了label:ci-pipeline-running
CANN-robotCANN-robot成员
7月6日 添加了label:ci-pipeline-passed
贾绍扬成员
7月6日 update merge request[project id: 8810053, iid: 3417, commit_id: d8dd5a4605b00d38cc70b1d76d21e3171e701c7f] virtual merging success
贾绍扬成员
7月6日 强制推送  1 个提交:2926d004-docs: 补充PeerAccessStatus约束说明
贾绍扬成员
7月6日 update merge request[project id: 8810053, iid: 3417, commit_id: 2933d4904dd4be6a53993d3f83278eae145a73e3] virtual merging success
CANN-robotCANN-robot成员
7月6日 删除了label:ci-pipeline-passed
CANN-robot
CANN-robot成员
7月6日 评论:

Notification

This pull request has been changed(code update) or closed, so removes the following label(s): ci-pipeline-passed.

likedislike
贾绍扬成员
7月6日 评论:

/compile

likedislike
贾绍扬成员
7月6日 update merge request[project id: 8810053, iid: 3417, commit_id: a62d6a66a58b3d7cf80d79fd6d5e2a45135da4b0] virtual merging success
CANN-robotCANN-robot成员
7月6日 添加了label:ci-pipeline-running
CANN-robot
CANN-robot成员
7月6日 评论:

流水线任务触发成功
任务链接 [d5412dd7b97f4dc6adc65e118ba64dec][流水线指导]

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
UT_Test_acl ✅ SUCCESS >>>>>
UT_Test_rts_v201 ✅ SUCCESS >>>>>
UT_Test_rts_c ✅ SUCCESS >>>>>
UT_Test_rts_david ✅ SUCCESS >>>>>
UT_Test_rts_910b ✅ SUCCESS >>>>>
UT_Test_rts_common ✅ SUCCESS >>>>>
UT_Test_platform ✅ SUCCESS >>>>>
UT_Test_qs ✅ SUCCESS >>>>>
UT_Test_aicpusd ✅ SUCCESS >>>>>
UT_Test_tsd ✅ SUCCESS >>>>>
UT_Test_error_manager ✅ SUCCESS >>>>>
UT_Test_slog ✅ SUCCESS >>>>>
UT_Test_atrace ✅ SUCCESS >>>>>
UT_Test_adump ✅ SUCCESS >>>>>
UT_Test_mmpa ✅ SUCCESS >>>>>
PreSmoke_A900_npupool ✅ SUCCESS >>>>>
UT_Test_msprof ✅ SUCCESS >>>>>
UT_Test_rts_report ✅ SUCCESS >>>>>
UT_Test_msprof_report ✅ SUCCESS

[2026-07-06 11:19:42]    CI执行结束

likedislike
CANN-robot
CANN-robot成员
7月6日 评论:

流水线任务触发成功
任务链接 [bf27170576a1487a948b7b14f5b597db][流水线指导]

任务名称状态日志下载链接
codecheck ✅ SUCCESS >>>>>
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_Check_Pr ✅ SUCCESS
codecheck_style ✅ SUCCESS >>>>>
codecheck_precommit ✅ SUCCESS >>>>> >>>>>
StaticCheck_codespell_check ✅ SUCCESS
StaticCheck_link_validity_check ✅ SUCCESS
StaticCheck_resource_existence_check ✅ SUCCESS
StaticCheck_tag_closed_check ✅ SUCCESS
StaticCheck_markdownlint ✅ SUCCESS

[2026-07-06 11:17:01]    CI执行结束

likedislike
atomgit-bot
atomgit-bot
7月6日 评论:

变更摘要

本次 PR 属于纯文档更新,旨在为 PeerAccessStatus 枚举补充状态说明,使该状态的文档描述更加完整。变更仅涉及 1 个文件,新增 4 行描述内容,无代码逻辑修改。

主要改动

  • 补充 PeerAccessStatus 状态说明:在相关文档中为 PeerAccessStatus 新增了状态描述信息,帮助开发者理解该枚举各状态值的含义与使用场景。
likedislike
CANN-robotCANN-robot成员
7月6日 删除了label:ci-pipeline-running
CANN-robotCANN-robot成员
7月6日 添加了label:ci-pipeline-passed
atomgit-bot
atomgit-bot
7月6日 评论:

代码审查

关闭总结

本次审查了 1 个变更文件:

  • docs/03_api_ref/04_Device管理.md:发现 1 个问题(P3)
优先级 数量
P0 0
P1 0
P2 0
P3 1

总体风险判断:低风险。此次变更为文档补充,新增了 aclrtDevicePeerAccessStatus 接口的约束说明。发现的问题仅涉及文档表述歧义("查询结果为0"在函数返回值0与status输出参数0之间存在二义性),可能误导调用者的边界条件处理逻辑,但不影响运行时正确性。建议在合入前澄清该表述。

⚠️ 已识别出整体风险,但无法提取行内评论,请参考整体评估。

likedislike
贾绍扬成员
7月6日 修改标题为 “【PR】:【9.1.0】docs: aclrtDevicePeerAccessStatus资料优化”,原标题为“【PR】:【9.1.0】docs: 补充PeerAccessStatus状态说明”
yanmingxiang成员
7月6日 评论:

/lgtm

likedislike
liulun0308成员
7月6日 评论:

/approve

likedislike
CANN-robotCANN-robot成员
7月6日 添加了label:lgtmapproved
CANN-robotCANN-robot成员
7月6日 合入了pull request