---
title: 函数：start_dump_args
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclpythondevg_01_1007.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclpythondevg_01_1007.html
indexId: d6dbf992408974a471ece68e974e0dc470f1d75cbca0af56cce69adab57d5dfd75
---
# 函数：start_dump_args

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | x |
| Atlas 200I/500 A2 推理产品 | x |


#### 功能说明

调用本接口开启算子信息统计功能，并需与函数：stop_dump_args接口配合使用，将算子信息文件输出到path参数指定的目录，一个shape对应一个算子信息文件，文件中包含算子类型、算子属性、算子输入&输出的format/数据类型/shape等信息。

使用场景：例如要统计某个模型执行涉及哪些算子，可在模型执行之前调用acl.op.start_dump_args接口，在模型执行之后调用acl.op.stop_dump_args接口，接口调用成功后，在path参数指定的目录下生成每个算子shape的算子信息文件。


#### 函数原型

- C函数原型
  1 aclError aclopStartDumpArgs(uint32_t dumpType, const char *path)

- python函数
  1 ret = acl.op.start_dump_args(dump_type, path)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| dumpType | int，指定dump信息的类型。 当前仅支持ACL\_OP\_DUMP\_OP\_AICORE\_ARGS，表示统计所有算子信息。 ACL\_OP\_DUMP\_OP\_AICORE\_ARGS = 0x00000001 |
| path | str，指定dump文件的保存路径，支持绝对路径或相对路径（指相对应用可执行文件所在的目录），但用户需确保路径存在或者该路径可以被创建。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

仅支持在单算子API执行场景下使用本接口，否则无法生成dump文件。

Atlas 推理系列产品 ，不支持该接口。

Atlas 200I/500 A2 推理产品 ，不支持该接口。

Atlas 训练系列产品 ，不支持该接口。

Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，不支持该接口。