Applicable Products

Product	Supported (√/x)
Ascend 950PR/Ascend 950DT	√
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Description

Registers the dump data callback function.

The Function: init_dump, Function: dump_reg_callback, Function: dump_unreg_callback, and Function: finalize_dump APIs are used together to obtain the dump data by using the callback function. (The callback function registered by using this API needs to be implemented by the user. The implementation logic of the callback function includes obtaining the dump data and data length.) The specific scenarios are exemplified as follows:

Execute a model and obtain dump data through callback.
The following two methods are supported:
- Disable model and single-operator dump configurations at the aclInit API.
  Function: init -->Function: init_dump -->Function: dump_reg_callback --> Model loading --> Model execution -->Function: dump_unreg_callback -->Function: finalize_dump --> Model unloading -->Function: finalize
- Enable model and single-operator dump configurations at the aclInit API. In this case, you need to configure the data storage path. However, if the Function: dump_reg_callback API is called, the data storage will not take effect, and the dump data obtained by the callback function will be used.
  Function: init -->Function: dump_reg_callback --> Model loading --> Model execution -->Function: dump_unreg_callback --> Model unloading -->Function: finalize
Execute two different models and obtain dump data through callback. In this context, as long as the callback function is not deregistered by calling Function: dump_unreg_callback, you can obtain the dump data of both models through the callback function.
Function: init --> Function: init_dump --> Function: dump_reg_callback --> Model 1 loading --> Model 1 execution --> --> Model 2 loading --> Model 2 execution --> Function: dump_unreg_callback --> Function: finalize_dump --> Model unloading --> Function: finalize

Prototype

C Prototype

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

Python Function

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

Parameters

Parameter	Description
mdl_dump_callback	Callback function used to receive callback data. It has the following parameters: dump_chunk: dict. When the mdl_dump_callback function is implemented, the values of parameters such as data_fuf and buf_len in dump_chunk can be obtained to obtain the dump data and data length. { "file_name": file_name, // Name of the dump file to be flushed to drives "data_buf": data_buf, // Memory address of the dump data "buf_len": buf_len, // data_buf length, in bytes "is_last_chunk": is_last_chunk, // Indicates whether the dump data is the last fragment. The value 0 indicates that the dump data is not the last fragment, and the value 1 indicates that the dump data is the last fragment. "offset": offset, // Offset of the dump data file content. -1 indicates the content to be added to the file. "flag": flag // Reserved dump data flag. The current data has no flag. }
flag	Int, whether to write dump data to a drive after the callback API is called. 0: no. Currently, only the value 0 is supported.

Parameter

Description

mdl_dump_callback

Callback function used to receive callback data. It has the following parameters:

dump_chunk: dict. When the mdl_dump_callback function is implemented, the values of parameters such as data_fuf and buf_len in dump_chunk can be obtained to obtain the dump data and data length.

{
    "file_name": file_name,   // Name of the dump file to be flushed to drives
    "data_buf": data_buf,     // Memory address of the dump data
    "buf_len": buf_len,       // data_buf length, in bytes
    "is_last_chunk": is_last_chunk, // Indicates whether the dump data is the last fragment. The value 0 indicates that the dump data is not the last fragment, and the value 1 indicates that the dump data is the last fragment.
    "offset": offset,         // Offset of the dump data file content. -1 indicates the content to be added to the file.
    "flag": flag              // Reserved dump data flag. The current data has no flag.
}

flag

Int, whether to write dump data to a drive after the callback API is called.

0: no. Currently, only the value 0 is supported.

Return Values

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Restrictions

None