Closed
[Documentation|文档反馈]: asinh_v2 与 asinh_with_agent 两篇 README 原型虚构不存在的 aclHandle 类型且参数个数错误 #3329
dihidaoAdd on  Sep 28Closed at  19 days ago
dihidao
dihidao
Sep 28 Create

场景:开发者按 asinh 系算子 README 的函数原型编写调用。

问题与位置(master 2026-09-28 核实):

  1. experimental/math/asinh_v2/README.md:85-95 原型第二段写 aclnnAsinhV2(aclHandle *handle, aclTensor *inputTensor, aclTensor *outputTensor, void workspaceAddr, uint64_t workspaceSize, aclrtStream stream)(6 参,第 4 参 aclHandle)—— 实际 op_api/aclnn_asinh_v2.h:51-52,61-62 两段式各 4 参(x, out, workspaceSize, executor / workspace, workspaceSize, executor, stream);aclHandle 在本仓全部头文件 0 命中(两段式执行器类型应为 aclOpExecutor);
  2. experimental/math/asinh_with_agent/README.md:88-96 同模式,:129 甚至写 aclHandle *handle = aclrtGetCurrentStream();(类型完全错配)—— 头文件 :51,62 实际各 4 参。

影响:照 README 原型写代码 → unknown type aclHandle / 参数个数不匹配,编译必然失败。

复现:master 对应行与 op_api 头文件比对;grep -rn aclHandle --include=*.h 全仓零命中。
修复建议:两篇按真实两段式签名重写原型。已检索本仓历史 issues,未见报告。

likedislike
陈思
陈思Collaborators
Sep 29 Comments:

您好,感谢反馈!核对 master(commit 77f7e4c2286fb5a6c5f473f6df25b07236fe49d7)中的两个接口头文件后,README 原型与真实的两段式接口不一致。两算子的第一段都接收输入张量 x、输出张量 out、workspaceSize 和 aclOpExecutor** executor,返回执行器;第二段都接收 workspace、workspaceSize、第一段返回的 aclOpExecutor* executor 和 aclrtStream stream。两份头文件的接口声明均不接受 aclHandle* 参数。

因此,执行器应由第一段接口通过 executor 输出,再传给第二段;合法的 aclrtStream 值作为第二段的 stream 参数传入,不能用 stream 代替 executor。按头文件修订两篇 README 的原型和调用示例,可以避免接口参数数量/类型不匹配。核查依据:AsinhV2 README、AsinhV2 接口头文件、AsinhWithAgent README、AsinhWithAgent 接口头文件。

likedislike
陈思陈思Collaborators
Sep 29 Assign wang-shilong32 as responsible person
dihidaodihidao
Oct 1 Associated pull request
ideal_ideal_Collaborators
19 days ago Associated pull request
ideal_ideal_Collaborators
19 days ago changed custom state from 进行中 to 已解决
ideal_ideal_Collaborators
19 days ago Close issue
dihidao
dihidao
17 days ago Comments:

@wang-shilong32 您好!注意到本 PR 的内容已随 !6602(commit c3474ccfbf)落地,感谢快速处理 🙏

想冒昧请问:能否在该 commit 信息中补一条 Co-authored-by: dihidao,以保留这份贡献记录?(本 PR 描述与改动即 !6602 的来源)若与仓库署名规范不符,忽略即可,谢谢!

likedislike