昇腾社区首页
中文
注册

函数:dump_reg_callback

C函数原型

aclError acldumpRegCallback(int32_t (* const messageCallback)(const acldumpChunk *, int32_t len), int32_t flag)

Python函数

ret = acl.mdl.dump_reg_callback(mdl_dump_callback, flag)

函数功能

Dump数据回调函数注册接口。

函数:init_dump接口、函数:dump_reg_callback接口(通过该接口注册的回调函数需由用户自行实现,回调函数实现逻辑中包括获取Dump数据及数据长度)、函数:dump_unreg_callback接口、函数:finalize_dump接口配合使用,用于通过回调函数获取Dump数据。场景举例如下:

输入说明

mdl_dump_callback:用于接收回调数据的回调,有如下两个参数:

  • dump_chunk:dict,在实现mdl_dump_callback函数时可以获取dump_chunk中的data_fuf、buf_len等参数值,用于获取Dump数据及其数据长度:
    {
        "file_name": file_name,   // 待落盘的Dump数据文件名
        "data_buf": data_buf,     // Dump数据的内存地址
        "buf_len": buf_len,       // data_buf数据长度,单位Byte
        "is_last_chunk": is_last_chunk, // 标识Dump数据是否为最后一个分片,0表示不是最后一个分片,1表示最后一个分片
        "offset": offset,         // Dump数据文件内容的偏移,其中-1表示文件追加内容
        "flag": flag              // 预留Dump数据标识,当前数据无标识
    }

flag:在调用回调接口后是否还落盘dump数据。

  • 0:不落盘,当前仅支持0

返回值说明

返回0表示成功,返回其它值表示失败。

约束说明