.. meta::
:description: Tensile 调试与实验特性环境变量，包括 kernel 选择、profiling 与调试信息
:keywords: Tensile, environment variables, debugging, profiling, GEMM, ROCm
.. _environment-variables:
环境变量 (Environment Variables)
本节列出 Tensile 客户端和应用程序可用的环境变量，用于测试、调试及实验功能。
.. list-table::
:header-rows: 1
:widths: 50,50
```
* - **环境变量**
- **用途与取值说明**
* - | ``TENSILE_DB``
| 启用调试功能，通过位字段组合控制输出信息类型。
- | 十六进制位字段值：
| ``0x2`` 或 ``0x4``：解决方案选择过程信息
| ``0x8``：硬件选择过程信息
| ``0x10``：Predicate 评估调试信息
| ``0x20``：代码对象库加载状态
| ``0x40``：核函数启动参数与设置
| ``0x80``：分配的张量大小
| ``0x100``：卷积参考计算调试信息
| ``0x200``：详细卷积参考计算
| ``0x1000``：库加载信息 (YAML/MessagePack)
| ``0x4000``：解决方案查找效率
| ``0x8000``：已选择的核函数名称
| ``0x80000``：详细核函数参数 (Matrix Instruction, MacroTile 等)
| ``0xFFFF``：启用所有调试输出
* - | ``TENSILE_DB2``
| 启用扩展调试特性。跳过核函数启动，但继续核函数选择和数据分配。
- | ``1``：启用扩展调试
| ``2``：禁用扩展调试
* - | ``TENSILE_NAIVE_SEARCH``
| 使用朴素搜索方式匹配核函数，而非优化搜索。
- | ``1``：启用朴素搜索
| ``2``：禁用朴素搜索
* - | ``TENSILE_TAM_SELECTION_ENABLE``
| 启用 Tile Aware 解决方案选择。
- | ``1``：启用 Tile Aware 选择
| ``2``：禁用 Tile Aware 选择
* - | ``TENSILE_SOLUTION_INDEX``
| 打印已选择的解决方案索引。
- | ``1``：启用打印
| ``2``：禁用打印
* - | ``TENSILE_METRIC``
| 覆盖解决方案选择默认距离度量。
- | "Euclidean"：欧几里得距离
| "JSD"：Jensen-Shannon 散度
| "Manhattan"：曼哈顿距离
| "Ratio"：比率度量
| "Random"：随机选择
* - | ``TENSILE_PROFILE``
| 启用对使用 @profile 装饰器的函数进行性能分析，生成 .prof 文件。
- | ``1``、"ON"、"TRUE"：启用 profiling
| 其他值：禁用 profiling
```