---
title: asc_dump
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_00202.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_00202.html
indexId: 1aaeba335a2092f7e98de0da55350f0b871ccd294018c4a235c2fc1c6d2b30aa77
---
# asc_dump

#### 产品支持情况

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


#### 功能说明

将对应内存上的数据打印出来，同时支持打印自定义的附加信息（仅支持uint32_t类型的信息），比如打印当前行号等。

使用该接口需要包含"utils/debug/asc_dump.h"头文件。


该功能主要用于调试和性能分析，开启后会对算子性能产生一定影响，通常在调测阶段使用，生产环境建议关闭。

默认情况下，该功能关闭，开发者需要在kernel核函数外定义如下宏定义:"#define ASCENDC_DUMP 1"，以开启dump功能。


#### 函数原型

```
// GM内存上的数据打印
template<typename T>
asc_dump_gm(__gm__ T* input, uint32_t desc, uint32_t dump_size)

// UB内存上的数据打印
template<typename T>
asc_dump_ubuf(__ubuf__ T* input, uint32_t desc, uint32_t dump_size)

// L1内存上的数据打印
template<typename T>
asc_dump_l1buf(__cbuf__ T* input, uint32_t desc, uint32_t dump_size)

// L0C内存上的数据打印
template<typename T>
asc_dump_cbuf(__cc__ T* input, uint32_t desc, uint32_t dump_size)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| T | 输入 | 待dump的数据类型。 |
| input | 输入 | 所需打印的内存块的起始地址。 |
| desc | 输入 | 自定义信息。uint32\_t类型，支持的数据范围是[0, 2^32 \- 1]。 |
| dump\_size | 输入 | 所需要打印的元素数量。 |


#### 返回值说明

无


#### 约束说明

- Ascend 950PR/Ascend 950DT暂时不支持L1上的内存打印。

- 使用该接口时，在每个核上dump的数据总量不能超过1M，请开发者自行控制打印的内容数据量，超出则不会打印。
- 在计算数据量时，若dump的总长度未对齐，需要考虑padding数据的影响。当进行非对齐dump时，如果实际dump的元素长度不满足32字节对齐。 系统会自动在其末尾补充一定数量的padding数据，以满足对其要求。
- 如果要正常使用dump功能，需要在kernel核函数外定义如下宏定义："#define ASCENDC_DUMP 1"。


#### 调用示例

```
__gm__ half* src;
uint32_t desc = 1;
uint32_t dump_size = 32;
asc_dump_gm<half>(src, desc, dump_size);
```