AI/rocm-systems
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added documentation for the new env var.

Browse Source 
Change-Id: I0407a5dd36e91a1ea205ce4dda9a7fca906e1266


[ROCm/rocminfo commit: a134847069]
This commit is contained in:
Wilfried Holzke
2019-10-21 20:32:54 +02:00
committed by Chris Freehill
parent 3960cc7d49
commit 86e8ee885c
2 changed files with 23 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
projects/rocminfo/README.md
+14
View File
@@ -27,3 +27,17 @@ cd ..
Upon a successful build the binary, rocminfo, and the python script,
rocm_agent_enumerator, will be in the build folder.
## Execution
"rocminfo" gives information about the HSA system attributes and agents.
"rocm_agent_enumerator" prints the list of available AMD GCN ISA. There exist four different ways how it is generated:
1. ROCM_TARGET_LST : a user defined environment variable, set to the path and filename where to find the "target.lst" file. This can be used in an install environment with sandbox, where execution of "rocminfo" is not possible.
2. target.lst : user-supplied text file, in the same folder as "rocm_agent_enumerator". This is used in a container setting where ROCm stack may usually not available.
3. rocminfo : a tool shipped with this script to enumerate GPU agents available on a working ROCm stack.
4. lspci : enumerate PCI bus and locate supported devices from a hard-coded lookup table.
projects/rocminfo/rocm_agent_enumerator
+9 -5
View File
@@ -68,7 +68,7 @@ def readFromTargetLstFile():
target = getGCNISA(line, match_from_beginning = True)
if target is not None:
target_list.append(target)
return target_list
def readFromROCMINFO():
@@ -123,11 +123,15 @@ def main():
The program collects the list in 3 different ways, in the order of
precendence:
1. target.lst : user-supplied text file. This is used in a container setting
1. ROCM_TARGET_LST : a user defined environment variable, set to the path and
filename where to find the "target.lst" file. This can be
used in an install environment with sandbox, where
execution of "rocminfo" is not possible.
2. target.lst : user-supplied text file. This is used in a container setting
where ROCm stack may usually not available.
2. rocminfo : a tool shipped with this script to enumerate GPU agents
3. rocminfo : a tool shipped with this script to enumerate GPU agents
available on a working ROCm stack.
3. lspci : enumerate PCI bus and locate supported devices from a hard-coded
4. lspci : enumerate PCI bus and locate supported devices from a hard-coded
lookup table.
"""
target_list = readFromTargetLstFile()
@@ -141,7 +145,7 @@ def main():
# workaround to cope with existing rocm_agent_enumerator behavior where gfx000
# would always be returned
print("gfx000")
for gfx in target_list:
print(gfx)