1ROCM-SMI(1)                      User Commands                     ROCM-SMI(1)
2
3
4

NAME

6       rocm-smi - manual page for rocm-smi 4.0.0
7

DESCRIPTION

9       usage: rocm-smi [-h] [-d DEVICE [DEVICE ...]] [--alldevices] [--showhw]
10       [-a] [-i] [-v] [--showdriverversion]
11
12              [--showfwinfo [BLOCK ...]]  [--showmclkrange]  [--showmemvendor]
13              [--showsclkrange]  [--showproductname]  [--showserial] [--showu‐
14              niqueid]  [--showvoltagerange]   [--showbus]   [--showpagesinfo]
15              [--showpendingpages]    [--showretiredpages]    [--showunreserv‐
16              ablepages] [-f] [-P] [-t]  [-u]  [--showmemuse]  [--showvoltage]
17              [-b] [-c] [-g] [-l] [-M] [-m] [-o] [-p] [-S] [-s] [--showmeminfo
18              TYPE [TYPE ...]] [--showpids] [--showpidgpus [PID ...]] [--show‐
19              pidusedmem  [PID  ...]] [--showreplaycount] [--showrasinfo BLOCK
20              [BLOCK  ...]]  [--showvc]  [--showxgmierr]  [-r]   [--resetfans]
21              [--resetprofile]     [--resetpoweroverdrive]    [--resetxgmierr]
22              [--setsclk LEVEL [LEVEL  ...]]  [--setmclk  LEVEL  [LEVEL  ...]]
23              [--setpcie LEVEL [LEVEL ...]] [--setslevel SCLKLEVEL SCLK SVOLT]
24              [--setmlevel MCLKLEVEL MCLK MVOLT] [--setvc  POINT  SCLK  SVOLT]
25              [--setsrange  MINMAX  SCLK]  [--setmrange MINMAX SCLK] [--setfan
26              LEVEL] [--setperflevel LEVEL] [--setoverdrive %]  [--setmemover‐
27              drive  %]  [--setpoweroverdrive WATTS] [--setprofile SETPROFILE]
28              [--rasenable BLOCK ERRTYPE] [--rasdisable BLOCK ERRTYPE] [--ras‐
29              inject  BLOCK]  [--gpureset]  [--load FILE | --save FILE] [--au‐
30              torespond RESPONSE] [--loglevel LEVEL] [--json] [--csv]
31
32       AMD ROCm System Management Interface
33
34   options:
35       -h, --help
36              show this help message and exit
37
38       --gpureset
39              Reset specified GPU (One GPU must be specified)
40
41       --load FILE
42              Load Clock, Fan, Performance and Profile settings from FILE
43
44       --save FILE
45              Save Clock, Fan, Performance and Profile settings to FILE
46
47       -d DEVICE [DEVICE ...], --device DEVICE [DEVICE ...]
48              Execute command on specified device
49
50   Display Options:
51       --alldevices
52              Execute command on non-AMD devices as well as AMD devices
53
54       --showhw
55              Show Hardware details
56
57       -a, --showallinfo
58              Show Temperature, Fan and Clock values
59
60   Topology:
61       -i, --showid
62              Show GPU ID
63
64       -v, --showvbios
65              Show VBIOS version
66
67       --showdriverversion
68              Show kernel driver version
69
70       --showfwinfo [BLOCK ...]
71              Show FW information
72
73       --showmclkrange
74              Show mclk range
75
76       --showmemvendor
77              Show GPU memory vendor
78
79       --showsclkrange
80              Show sclk range
81
82       --showproductname
83              Show SKU/Vendor name
84
85       --showserial
86              Show GPU's Serial Number
87
88       --showuniqueid
89              Show GPU's Unique ID
90
91       --showvoltagerange
92              Show voltage range
93
94       --showbus
95              Show PCI bus number
96
97   Pages information:
98       --showpagesinfo
99              Show retired, pending and unreservable pages
100
101       --showpendingpages
102              Show pending retired pages
103
104       --showretiredpages
105              Show retired pages
106
107       --showunreservablepages
108              Show unreservable pages
109
110   Hardware-related information:
111       -f, --showfan
112              Show current fan speed
113
114       -P, --showpower
115              Show current Average Graphics Package Power Consumption
116
117       -t, --showtemp
118              Show current temperature
119
120       -u, --showuse
121              Show current GPU use
122
123       --showmemuse
124              Show current GPU memory used
125
126       --showvoltage
127              Show current GPU voltage
128
129   Software-related/controlled information:
130       -b, --showbw
131              Show estimated PCIe use
132
133       -c, --showclocks
134              Show current clock frequencies
135
136       -g, --showgpuclocks
137              Show current GPU clock frequencies
138
139       -l, --showprofile
140              Show Compute Profile attributes
141
142       -M, --showmaxpower
143              Show maximum graphics package power this GPU will consume
144
145       -m, --showmemoverdrive
146              Show current GPU Memory Clock OverDrive level
147
148       -o, --showoverdrive
149              Show current GPU Clock OverDrive level
150
151       -p, --showperflevel
152              Show current DPM Performance Level
153
154       -S, --showclkvolt
155              Show supported GPU and Memory Clocks and Voltages
156
157       -s, --showclkfrq
158              Show supported GPU and Memory Clock
159
160       --showmeminfo TYPE [TYPE ...]
161              Show Memory usage information for given block(s) TYPE
162
163       --showpids
164              Show current running KFD PIDs
165
166       --showpidgpus [PID ...]
167              Show GPUs used by specified KFD PIDs (all if no arg given)
168
169       --showpidusedmem [PID ...]
170              Show amount of memory used by specified KFD PIDs (all if no  arg
171              given))
172
173       --showreplaycount
174              Show PCIe Replay Count
175
176       --showrasinfo BLOCK [BLOCK ...]
177              Show  RAS enablement information and error counts for the speci‐
178              fied block(s)
179
180       --showvc
181              Show voltage curve
182
183       --showxgmierr
184              Show XGMI error information since last read
185
186   Set options:
187       --setsclk LEVEL [LEVEL ...]
188              Set GPU Clock Frequency Level(s) (requires manual Perf level)
189
190       --setmclk LEVEL [LEVEL ...]
191              Set GPU Memory Clock Frequency Level(s)  (requires  manual  Perf
192              level)
193
194       --setpcie LEVEL [LEVEL ...]
195              Set PCIE Clock Frequency Level(s) (requires manual Perf level)
196
197       --setslevel SCLKLEVEL SCLK SVOLT
198              Change GPU Clock frequency (MHz) and Voltage (mV) for a specific
199              Level
200
201       --setmlevel MCLKLEVEL MCLK MVOLT
202              Change GPU Memory clock frequency (MHz) and Voltage for  (mV)  a
203              specific Level
204
205       --setvc POINT SCLK SVOLT
206              Change SCLK Voltage Curve (MHz mV) for a specific point
207
208       --setsrange MINMAX SCLK
209              Set min(0) or max(1) SCLK speed
210
211       --setmrange MINMAX SCLK
212              Set min(0) or max(1) MCLK speed
213
214       --setfan LEVEL
215              Set GPU Fan Speed (Level or %)
216
217       --setperflevel LEVEL
218              Set Performance Level
219
220       --setoverdrive %
221              Set GPU OverDrive level (requires manual|high Perf level)
222
223       --setmemoverdrive %
224              Set  GPU  Memory Overclock OverDrive level (requires manual|high
225              Perf level)
226
227       --setpoweroverdrive WATTS
228              Set the maximum GPU power using Power OverDrive in Watts
229
230       --setprofile SETPROFILE
231              Specify Power Profile level (#) or a  quoted  string  of  CUSTOM
232              Profile attributes "# # # #..." (requires manual Perf level)
233
234       --rasenable BLOCK ERRTYPE
235              Enable RAS for specified block and error type
236
237       --rasdisable BLOCK ERRTYPE
238              Disable RAS for specified block and error type
239
240       --rasinject BLOCK
241              Inject  RAS  poison  for specified block (ONLY WORKS ON UNSECURE
242              BOARDS)
243
244   Reset options:
245       -r, --resetclocks
246              Reset clocks and OverDrive to default
247
248       --resetfans
249              Reset fans to automatic (driver) control
250
251       --resetprofile
252              Reset Power Profile back to default
253
254       --resetpoweroverdrive
255              Set the maximum GPU power back to the device deafult state
256
257       --resetxgmierr
258              Reset XGMI error count
259
260   Auto-response options:
261       --autorespond RESPONSE
262              Response to automatically provide for all  prompts  (NOT  RECOM‐
263              MENDED)
264
265   Output options:
266       --loglevel LEVEL
267              How  much  output will be printed for what program is doing, one
268              of debug/info/warning/error/critical
269
270       --json Print output in JSON format
271
272       --csv  Print output in CSV format
273
274
275
276rocm-smi 4.0.0                   January 2022                      ROCM-SMI(1)