MESA3D 中环境变量使用说明
==========================

MESA
##########################

+-----------+----------------+-----------------------------------+
| 环境变量  | 设置的值       |  作用                             |
+-----------+----------------+-----------------------------------+
| MESA_GLSL | dump           | dump shader 到 stdout             |
|           +----------------+-----------------------------------+
|           | log            | dump shader 到文件                |
|           +----------------+-----------------------------------+
|           | uniforms       | 打印glUniform的调用               |
|           +----------------+-----------------------------------+
|           | nop_vert       |                                   |
|           +----------------+-----------------------------------+
|           | nop_frag       |                                   |
|           +----------------+-----------------------------------+
|           | use_prog       | 打印 glUseProgram调用             |
|           +----------------+-----------------------------------+
|           | report_errors  | 打印编译错误                      |
|           +----------------+-----------------------------------+
|           | dump_on_error  | 错误时dump                        |
|           +----------------+-----------------------------------+
|           | cache_info     | 打印cache信息                     |
|           +----------------+-----------------------------------+
|           | cache_fallback |                                   |
|           +----------------+-----------------------------------+
|           | source         | 仅dump GLSL                       |
+-----------+----------------+-----------------------------------+

Gallium
##########################

+---------------------+----------+----------------------------------------+
| 环境变量            | 设置的值 |  作用                                  |
+---------------------+----------+----------------------------------------+
| GALLIUM_LOG_FILE    | filename | 将Gallium的日志保存在制定的文件中，    |
|                     |          | 可以设置为stdout将日志输出到标准输出   |
+---------------------+----------+----------------------------------------+
| GALLIUM_NOSSE       | bool     | 设定GALLIUM是否使用SSE的扩展指令集     |
+---------------------+----------+----------------------------------------+
| GALLIUM_DUMP_CPU    | bool     | 设定是否将CPU的信息打印出来            |
+---------------------+----------+----------------------------------------+

Gallivm
##########################

+---------------------+----------+----------------------------------------+
| 环境变量            | 设置的值 |  作用                                  |
+---------------------+----------+----------------------------------------+
| GALLIVM_DEBUG       | tgsi     | 打印输出TGSI的信息                     |
|                     +----------+----------------------------------------+
|                     | ir       | 打印输出LLVM IR的信息                  |
|                     +----------+----------------------------------------+
|                     | asm      | 打印输出目标的会编码                   |
|                     +----------+----------------------------------------+
|                     | perf     | TODO                                   |
|                     +----------+----------------------------------------+
|                     | gc       | TODO                                   |
|                     +----------+----------------------------------------+
|                     | dumpbc   | 将BC信息dump到文件中                   |
+---------------------+----------+----------------------------------------+

NIR
##########################

+---------------------+------------------------+-----------------------------------+
| 环境变量            | 设置的值               |  作用                             |
+---------------------+------------------------+-----------------------------------+
| NIR_DEBUG           | clone                  | TODO                              |
|                     +------------------------+-----------------------------------+
|                     | serialize              | TODO                              |
|                     +------------------------+-----------------------------------+
|                     | novalidate             | TODO                              |
|                     +------------------------+-----------------------------------+
|                     | validate_ssa_dominance | TODO                              |
|                     +------------------------+-----------------------------------+
|                     | tgsi                   | 在做NIR<->TGSI转换时DUMP NIR/TGSI |
|                     +------------------------+-----------------------------------+
|                     | print                  | DUMP shader                       |
|                     +------------------------+-----------------------------------+
|                     | print_vs               | DUMP vs shader                    |
|                     +------------------------+-----------------------------------+
|                     | print_tcs              | DUMP tcs shader                   |
|                     +------------------------+-----------------------------------+
|                     | print_tes              | DUMP tes shader                   |
|                     +------------------------+-----------------------------------+
|                     | print_gs               | DUMP gs shader                    |
|                     +------------------------+-----------------------------------+
|                     | print_fs               | DUMP fs shader                    |
|                     +------------------------+-----------------------------------+
|                     | print_cs               | DUMP cs shader                    |
|                     +------------------------+-----------------------------------+
|                     | print_ts               | DUMP task shader                  |
|                     +------------------------+-----------------------------------+
|                     | print_ms               | DUMP mesh shader                  |
|                     +------------------------+-----------------------------------+
|                     | print_rgs              | DUMP raygen shader                |
|                     +------------------------+-----------------------------------+
|                     | print_ahs              | DUMP any-hit shader               |
|                     +------------------------+-----------------------------------+
|                     | print_chs              | DUMP closest-hit shader           |
|                     +------------------------+-----------------------------------+
|                     | print_mhs              | DUMP miss-hit shader              |
|                     +------------------------+-----------------------------------+
|                     | print_is               | DUMP intersection shader          |
|                     +------------------------+-----------------------------------+
|                     | print_cbs              | DUMP callable shader              |
|                     +------------------------+-----------------------------------+
|                     | print_ks               | DUMP kernel shader                |
|                     +------------------------+-----------------------------------+
|                     | print_consts           | 打印const值                       |
|                     +------------------------+-----------------------------------+
|                     | print_internal         | 打印内部shader                    |
+---------------------+------------------------+-----------------------------------+

参考资料：  

- https://gitee.com/rvgpu/rvgpu-mesa/blob/rvgpu/src/compiler/nir/nir.c#L45