Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit d2c19cf

Browse files
committedMar 14, 2025·
Docs: Add a few more env variables
1 parent 511d5a0 commit d2c19cf

File tree

1 file changed

+33
-13
lines changed

1 file changed

+33
-13
lines changed
 

‎docs/data/env_variables_hip.rst

+33-13
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ The GPU isolation environment variables in HIP are collected in the following ta
1212
:header-rows: 1
1313
:widths: 70,30
1414

15-
* - **Environment variable**
16-
- **Value**
15+
* - Environment variable
16+
- Value
1717

1818
* - | ``ROCR_VISIBLE_DEVICES``
1919
| A list of device indices or UUIDs that will be exposed to applications.
@@ -37,8 +37,8 @@ The profiling environment variables in HIP are collected in the following table.
3737
:header-rows: 1
3838
:widths: 70,30
3939

40-
* - **Environment variable**
41-
- **Value**
40+
* - Environment variable
41+
- Value
4242

4343
* - | ``HSA_CU_MASK``
4444
| Sets the mask on a lower level of queue creation in the driver,
@@ -66,9 +66,9 @@ The debugging environment variables in HIP are collected in the following table.
6666
:header-rows: 1
6767
:widths: 35,14,51
6868

69-
* - **Environment variable**
70-
- **Default value**
71-
- **Value**
69+
* - Environment variable
70+
- Default value
71+
- Value
7272

7373
* - | ``AMD_LOG_LEVEL``
7474
| Enables HIP log on various level.
@@ -110,6 +110,13 @@ The debugging environment variables in HIP are collected in the following table.
110110
| 0x80000: Timestamp details.
111111
| 0xFFFFFFFF: Log always even mask flag is zero.
112112
113+
* - | ``HIP_FORCE_DEV_KERNARG``
114+
| Forces kernel arguments to be stored in device memory to reduce latency.
115+
| Can improve performance by 2-3 µs for some kernels.
116+
- ``0``
117+
- | 0: Disable
118+
| 1: Enable
119+
113120
* - | ``HIP_LAUNCH_BLOCKING``
114121
| Used for serialization on kernel execution.
115122
- ``0``
@@ -169,9 +176,9 @@ following table.
169176
:header-rows: 1
170177
:widths: 35,14,51
171178

172-
* - **Environment variable**
173-
- **Default value**
174-
- **Value**
179+
* - Environment variable
180+
- Default value
181+
- Value
175182

176183
* - | ``HIP_HIDDEN_FREE_MEM``
177184
| Amount of memory to hide from the free memory reported by hipMemGetInfo.
@@ -213,6 +220,19 @@ following table.
213220
- | 0: Disable
214221
| 1: Enable
215222
223+
* - | ``GPU_MAX_ALLOC_PERCENT``
224+
| Restricts the total percentage of GPU memory that a single application can allocate.
225+
| Critical for APU systems with shared CPU/GPU memory.
226+
- None
227+
- | Unit: Percentage
228+
| Setting to 100 allows maximum memory use but increases Out-Of-Memory risk.
229+
230+
* - | ``GPU_SINGLE_ALLOC_PERCENT``
231+
| Limits the maximum size of a single memory allocation as a percentage of GPU memory.
232+
- None
233+
- | Unit: Percentage
234+
| Prevents single allocations from consuming all available GPU memory.
235+
216236
* - | ``GPU_MAX_HEAP_SIZE``
217237
| Set maximum size of the GPU heap to % of board memory.
218238
- ``100``
@@ -268,9 +288,9 @@ different features in HIP.
268288
:header-rows: 1
269289
:widths: 35,14,51
270290

271-
* - **Environment variable**
272-
- **Default value**
273-
- **Value**
291+
* - Environment variable
292+
- Default value
293+
- Value
274294

275295
* - | ``HIPRTC_COMPILE_OPTIONS_APPEND``
276296
| Sets compile options needed for ``hiprtc`` compilation.

0 commit comments

Comments
 (0)
Please sign in to comment.