Skip to content

msdebug_faq.md

Latest commit

 

History

History
172 lines (116 loc) · 6.63 KB

msdebug_faq.md

File metadata and controls

172 lines (116 loc) · 6.63 KB
Raw

FAQ

msDebug工具打印Tensor变量功能不可用，提示“unavailable”或“memory read failed”

问题现象

提示“unavailable”或“Failed to dereference pointer from xxx for DW_OP_deref: memory read failed for xxx”。

原因分析

单步调试功能不支持Tensor按值传递的写法。

解决方案

当打印对象a为Tensor类型且以值传递作为函数入参时会出现该问题。

void Foo(const LocalTensor<float> a); // 该写法变量a打印失败

若需打印该变量，可修改代码使对象a以引用传递作为函数入参，修复该问题。

void Foo(const LocalTensor<float> &a); // 该写法变量a可正常打印

msDebug工具在容器环境中调试运行失败，提示需安装HDK驱动包

问题现象

提示msdebug failed to initialize. please install HDK with --debug before debugging。

原因分析

未使用--debug选项安装HDK驱动包或msDebug工具依赖的驱动设备节点/dev/drv_debug未映射至容器环境内。

解决方案

  1. 检查宿主机是否使用--debug选项安装HDK驱动包。

    若回显一致，则调试驱动已安装；否则需要使用--debug命令安装配套的HDK驱动包。

    [mindstudio@localhost ~]$ ls /dev/drv_debug     #查看是否存在/dev/drv_debug设备节点
/dev/drv_debug

  2. 若驱动包已安装，算子运行环境为容器环境，那么请检查该容器环境中是否满足以下条件。

    • 能找到调试依赖的设备节点/dev/drv_debug。
    • 容器环境具有该设备节点的访问权限。

    [!NOTE]
    建议在容器启动命令中增加选项--privileged --device=/dev/drv_debug，可保证调试依赖的设备节点被映射，且允许容器环境访问该节点。

msDebug工具断点设置在核函数内，命中断点后执行continue命令，算子运行失败

问题现象

打印信息Synchronize stream failed. error code is 507035，查看plog显示aic error code=0x8000000000000000，并且在命中断点时使用ascend info cores命令可以看到当前核的PC值与预期不符。

原因分析

Kernel函数中workspace入参的空间大小在Tiling函数中被设置为0，经过单算子API调用后变成一个非法地址。虽然workspace入参在Kernel函数未被使用，调试器展示Kernel入参时也会对workspace指针进行解引用，导致算子运行错误。

解决方案

参考《Ascend C算子开发指南》中的“算子实现 > 工程化算子开发 > Host侧tiling实现”章节，将workspacesize从0设置成预留内存大小。API在计算过程需要一些workspace内存作为缓存，因此算子Tiling函数需要为API预留workspace内存，预留内存大小通过GetLibApiWorkSpaceSize接口获取。参考如下代码：

#include "tiling/platform/platform_ascendc.h"
auto ascendcPlatform = platform_ascendc::PlatformAscendC(context->GetPlatformInfo());
size_t systemWorkspaceSize = ascendcPlatform.GetLibApiWorkSpaceSize();
size_t*currentWorkspace = context->GetWorkspaceSizes(1); // 只使用1块Workspace
currentWorkspace[0]= systemWorkspaceSize;

msDebug工具在docker中执行"run"命令运行程序后，提示“'A' packet returned an error: 8”

问题现象

在docker中，msDebug工具在执行"run"命令运行程序后，出现以下报错。

(msdebug) run
'A' packet returned an error: 8
(msdebug)
...

原因分析

出现该错误，可能与“地址空间布局随机化”有关。

解决方案

需输入并执行下列命令来规避此问题。

...
(msdebug) settings set target.disable-aslr false
...

编译时出现报错error: undefined symbol: g_opSystemRunCfg

问题现象

在O0编译时，出现以下报错。

ld.lld: error: undefined symbol: g_opSystemRunCfg

解决方案

需要去掉编译选项- DL2_CACHE_HINT。

命中断点的代码位置与预期不符

问题现象

设置的断点行号与实际命中的代码行不一致。

原因分析

  • 原因1：Host侧和Kernel侧存在同名文件，程序启动时先命中了Host侧文件的断点。若Host侧该行无断点，调试器会往下寻找最近的可用行。
  • 原因2：Kernel文件的目标行没有断点信息，调试器默认往下寻找最近的可用行。这属于工具的预期行为，通常是因为编译器在该行进行了优化，或Kernel未使用-O0编译。

解决方案

  • 原因1：若回显中没有[Switching to focus...]且stop reason = breakpoint x，说明命中的是Host侧断点，执行c继续运行即可命中Kernel侧断点。Host侧断点地址通常以0x7ff开头，Kernel侧断点地址通常以device_debugdata开头。
  • 原因2：确保Kernel使用-g -O0选项编译，避免编译器优化导致断点信息丢失。

以下为原因1的示例。设置第28行断点后，先命中了Host侧（libascendc_ops.so）的第49行：

(msdebug) b add_custom_kernel.asc:28
Breakpoint 1: no locations (pending on future shared library load).
WARNING:  Unable to resolve breakpoint to any actual locations.
(msdebug) r
...
1 location added to breakpoint 1
[Launch of Kernel _ZN11ascendc_ops10add_customEPfS0_S0_ on Device 0]
1 location added to breakpoint 1
Process 1436447 stopped
* thread #1, name = 'python3', stop reason = breakpoint 1.1
    frame #0: 0x00007ffe53b8a232 libascendc_ops.so`ascendc_ops::add_custom(cce_launch_config.block=8, cce_launch_config.dynamicShmemSz=0, cce_launch_config.stream=0x0000555583616d38, x=0x000012004ce30800, y=0x000012004ce20800, z=<unavailable>) at add_custom_kernel.asc:49:1
   46
   47       AscendC::DataCopy(zGm, zLocal, BLOCK_LENGTH);
   48       AscendC::PipeBarrier<PIPE_ALL>();
-> 49   }
   50   } // namespace ascendc_ops

执行c继续运行，命中Kernel侧断点：

(msdebug) c
Process 1436447 resuming
Process 1436447 stopped
[Switching to focus on Kernel _ZN11ascendc_ops10add_customEPfS0_S0_, CoreId 36, Type aiv]
* thread #1, name = 'python3', stop reason = breakpoint 1.2
    frame #0: 0x000012004100011c device_debugdata_0`ascendc_ops::add_custom(x=0x12004ce30800, y=0x12004ce20800, z=0x12004ce40800) at add_custom_kernel.asc:31:27
   28       AscendC::GlobalTensor<float> xGm;
   29       AscendC::GlobalTensor<float> yGm;
   30       AscendC::GlobalTensor<float> zGm;
-> 31       xGm.SetGlobalBuffer(x + block_idx * BLOCK_LENGTH, BLOCK_LENGTH);
   32       yGm.SetGlobalBuffer(y + block_idx * BLOCK_LENGTH, BLOCK_LENGTH);
   33       zGm.SetGlobalBuffer(z + block_idx * BLOCK_LENGTH, BLOCK_LENGTH);
   34