Closed
[Bug-Report|缺陷反馈]: 单算子自定义包首次安装必现中止——libcust_opsproto_rt2.0.so 的 NEEDED 缺少 acl_rt(undefined symbol: aclsysGetVersionNum) #8319
HuangRZzzzAdd on  15 days agoClosed at  13 days ago
HuangRZzzz
HuangRZzzzCollaborators
15 days ago Create

Describe the current behavior / 问题描述

按《QUICKSTART.md》/《源码构建》说明用单算子("变薄")方式编译自定义算子包后,首次安装必然中止:

bash build.sh --pkg --soc=ascend910_93 --ops=add_example -j40
./build_out/cann-ops-nn-custom_linux-aarch64.run

报错:

[ops_custom] [INFO] validate shared libraries before installation
[ops_custom] [ERROR] Failed to load libcust_opsproto_rt2.0.so wish env ASCEND_HOME_PATH(...), error message is libcust_opsproto_rt2.0.so: undefined symbol: aclsysGetVersionNum.
[ops_custom] [ERROR] Shared library validation failed. To skip this validation and continue installation, run this package again with --force.

即安装脚本对 libcust_opsproto_rt2.0.so 做 dlopen(RTLD_NOW) 校验时,因符号 aclsysGetVersionNum 未解析而中止;当前文档/FAQ 只能建议 --force 绕过(不建议默认使用)。

根因分析

  • cmake/symbol.cmake 的 gen_cust_proto_symbol() 中,cust_proto(OBJECT 库,最终打包为 libcust_opsproto_rt2.0.so)的链接行只有 intf_pub_cxx17、ge_compiler(以及 es_math/es_nn),缺少 acl_rt。
  • 打包进该库的 opbase 源码(third_party/opbase/src/nnopbase/individual_op/executor/*.cpp 等)引用 aclsysGetVersionNum,该符号由 ACL 运行时(libacl_rt.so / libascendcl.so)提供。
  • 共享库链接默认允许未解析符号,因此 libcust_opsproto_rt2.0.so 的 DT_NEEDED 不含 ACL 运行时;安装时的共享库校验用 dlopen(RTLD_NOW) 会立即暴露该 undefined symbol 并中止安装。
  • 对照:内置包路径的 gen_ophost_symbol() 链接了 -Wl,--no-as-needed acl_rt -Wl,--as-needed,自定义(gen_cust_proto_symbol)路径缺失,属打包配置缺陷。

复现与证据(CANN 9.2.0 / aarch64 / master b5949092)

bash build.sh --pkg --soc=ascend910_93 --ops=add_example -j40
readelf -d build_out/_CPack_Packages/.../op_proto/lib/linux/aarch64/libcust_opsproto_rt2.0.so | grep NEEDED
# 修复前:NEEDED 无 libacl_rt.so / libascendcl.so
nm -D --undefined-only <同上 so> | grep aclsysGetVersionNum   # U aclsysGetVersionNum
bash build_out/_CPack_Packages/.../install.sh --install-path=/tmp/xxx   # 复现上述 ERROR 并中止

Describe the expected behavior / 预期结果

单算子自定义包按 QUICKSTART 直接安装成功,不需要 --force。

修复建议

在 cmake/symbol.cmake 的 gen_cust_proto_symbol() 中为 cust_proto 补充 ACL 运行时依赖(随对象库传递到最终打包的 .so):

target_link_libraries(
  cust_proto
  PUBLIC $<BUILD_INTERFACE:intf_pub_cxx17>
  ge_compiler
  INTERFACE
  -Wl,--no-as-needed
  acl_rt
  -Wl,--as-needed
  )

本地验证(已按此修复重编/重装):

  • readelf -d libcust_opsproto_rt2.0.so 的 NEEDED 已包含 libacl_rt.so;
  • 安装脚本输出 SUCCESS,不再出现 shared library validation failed,无需 --force。

Environment / 环境信息

  • 仓库/commit:cann/ops-nn master b5949092
  • CANN:9.2.0,aarch64;gcc 13
  • 构建:bash build.sh --pkg --soc=ascend910_93 --ops=add_example -j40
likedislike
HuangRZzzzHuangRZzzzCollaborators
15 days ago Associated pull request
HuangRZzzz
HuangRZzzzCollaborators
15 days ago Comments:

已提交修复 PR:#13838(https://gitcode.com/cann/ops-nn/pulls/13838)——`cmake/symbol.cmake` 的 gen_cust_proto_symbol() 为 cust_proto 补充 acl_rt(INTERFACE 传递到打包 .so)。本地验证:重建后 libcust_opsproto_rt2.0.so 的 NEEDED 包含 libacl_rt.so,安装脚本输出 SUCCESS、无需 --force。

likedislike
yuning_chenyuning_chenCollaborators
15 days ago Assign HuangRZzzz as responsible person
CANN-robotCANN-robotCollaborators
13 days ago Close issue
CANN-robotCANN-robotCollaborators
13 days ago changed custom state from 进行中 to 已完成
CANN-robotCANN-robotCollaborators
13 days ago Added label: resolved
dengguojiedengguojie
4 days ago Associated pull request