Function: start_dump_args

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	x
Atlas 200I/500 A2 inference products	x

Description

Enables the operator statistics function. This API must be used in pair with Function: stop_dump_args to export the operator information files to the directory specified by path. One shape corresponds to one operator information file, which contains the operator type, operator attributes, and operator input and output information such as format, data type, and shape.

Application scenario: For example, if you want to collect statistics on the operators involved in the execution of a model, you can call the acl.op.start_dump_args API before the model execution and call the acl.op.stop_dump_args API after the model execution. After the successful acl.op.start_dump_args call, an operator information file for each operator shape is generated in the directory specified by path.

Prototype

C Prototype

aclError aclopStartDumpArgs(uint32_t dumpType, const char *path)

Python Function

ret = acl.op.start_dump_args(dump_type, path)

Parameters

Parameter	Description
dumpType	Int, type of dump information. Currently, only ACL_OP_DUMP_OP_AICORE_ARGS is supported, indicating that information about all operators is collected. ACL_OP_DUMP_OP_AICORE_ARGS = 0x00000001
path	Str, path for storing dump files. The path can be an absolute path or a relative path (relative to the directory where the executable file of the application is located). Ensure that the path exists or can be created.

Parameter

Description

dumpType

Int, type of dump information.

Currently, only ACL_OP_DUMP_OP_AICORE_ARGS is supported, indicating that information about all operators is collected.

ACL_OP_DUMP_OP_AICORE_ARGS = 0x00000001

path

Str, path for storing dump files. The path can be an absolute path or a relative path (relative to the directory where the executable file of the application is located). Ensure that the path exists or can be created.

Return Values

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

Restrictions

This API can be used only in the single-operator API execution scenario. Otherwise, dump files cannot be generated.

Parent topic: Dump Configuration