---
name: "rocm-smi"
section: "1"
platform: "linux"
package: "rocm-smi"
version: "6.1.2-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rocm-smi"
---

# rocm-smi(1)

rocm-smi - a tool to monitor AMD accelerators and GPUs

## NAME

rocm-smi - rocm-smi - a tool to monitor AMD accelerators and GPUs

## DESCRIPTION

usage: rocm-smi \[-h\] \[-V\] \[-d DEVICE \[DEVICE ...\]\] \[--alldevices\] \[--showhw\] \[-a\] \[-i\] \[-v\] \[-e \[EVENT ...\]\]

-

  \[--showdriverversion\] \[--showtempgraph\] \[--showfwinfo \[BLOCK ...\]\] \[--showmclkrange\] \[--showmemvendor\] \[--showsclkrange\] \[--showproductname\] \[--showserial\] \[--showuniqueid\] \[--showvoltagerange\] \[--showbus\] \[--showpagesinfo\] \[--showpendingpages\] \[--showretiredpages\] \[--showunreservablepages\] \[-f\] \[-P\] \[-t\] \[-u\] \[--showmemuse\] \[--showvoltage\] \[-b\] \[-c\] \[-g\] \[-l\] \[-M\] \[-m\] \[-o\] \[-p\] \[-S\] \[-s\] \[--showmeminfo TYPE \[TYPE ...\]\] \[--showpids \[VERBOSE\]\] \[--showpidgpus \[SHOWPIDGPUS ...\]\] \[--showreplaycount\] \[--showrasinfo \[SHOWRASINFO ...\]\] \[--showvc\] \[--showxgmierr\] \[--showtopo\] \[--showtopoaccess\] \[--showtopoweight\] \[--showtopohops\] \[--showtopotype\] \[--showtoponuma\] \[--showenergycounter\] \[--shownodesbw\] \[--showcomputepartition\] \[--showmemorypartition\] \[-r\] \[--resetfans\] \[--resetprofile\] \[--resetpoweroverdrive\] \[--resetxgmierr\] \[--resetperfdeterminism\] \[--resetcomputepartition\] \[--resetmemorypartition\] \[--setclock TYPE LEVEL\] \[--setsclk LEVEL \[LEVEL ...\]\] \[--setmclk LEVEL \[LEVEL ...\]\] \[--setpcie LEVEL \[LEVEL ...\]\] \[--setslevel SCLKLEVEL SCLK SVOLT\] \[--setmlevel MCLKLEVEL MCLK MVOLT\] \[--setvc POINT SCLK SVOLT\] \[--setsrange SCLKMIN SCLKMAX\] \[--setextremum min\|max sclk\|mclk CLK\] \[--setmrange MCLKMIN MCLKMAX\] \[--setfan LEVEL\] \[--setperflevel LEVEL\] \[--setoverdrive %\] \[--setmemoverdrive %\] \[--setpoweroverdrive WATTS\] \[--setprofile SETPROFILE\] \[--setperfdeterminism SCLK\] \[--setcomputepartition {CPX,SPX,DPX,TPX,QPX,cpx,spx,dpx,tpx,qpx}\] \[--setmemorypartition {NPS1,NPS2,NPS4,NPS8,nps1,nps2,nps4,nps8}\] \[--rasenable BLOCK ERRTYPE\] \[--rasdisable BLOCK ERRTYPE\] \[--rasinject BLOCK\] \[--gpureset\] \[--load FILE \| **--save** FILE\] \[--autorespond RESPONSE\] \[--loglevel LEVEL\] \[--json\] \[--csv\]

AMD ROCm System Management Interface \| ROCM-SMI version: 2.2.0

### options:

- **-h**, **--help**

  show this help message and exit

- **--gpureset**

  Reset specified GPU (One GPU must be specified)

- **--load** FILE

  Load Clock, Fan, Performance and Profile settings from FILE

- **--save** FILE

  Save Clock, Fan, Performance and Profile settings to FILE

- **-V**, **--version**

  Show version information

- **-d** DEVICE \[DEVICE ...\], **--device** DEVICE \[DEVICE ...\]

  Execute command on specified device

### Display Options:

**--alldevices**

- **--showhw**

  Show Hardware details

- **-a**, **--showallinfo**

  Show Temperature, Fan and Clock values

### Topology:

- **-i**, **--showid**

  Show DEVICE IDs

- **-v**, **--showvbios**

  Show VBIOS version

- **-e** \[EVENT ...\], **--showevents** \[EVENT ...\]

  Show event list

- **--showdriverversion**

  Show kernel driver version

- **--showtempgraph**

  Show Temperature Graph

- **--showfwinfo** \[BLOCK ...\]

  Show FW information

- **--showmclkrange**

  Show mclk range

- **--showmemvendor**

  Show GPU memory vendor

- **--showsclkrange**

  Show sclk range

- **--showproductname**

  Show product details

- **--showserial**

  Show GPU's Serial Number

- **--showuniqueid**

  Show GPU's Unique ID

- **--showvoltagerange**

  Show voltage range

- **--showbus**

  Show PCI bus number

### Pages information:

- **--showpagesinfo**

  Show retired, pending and unreservable pages

- **--showpendingpages**

  Show pending retired pages

- **--showretiredpages**

  Show retired pages

- **--showunreservablepages**

  Show unreservable pages

### Hardware-related information:

- **-f**, **--showfan**

  Show current fan speed

- **-P**, **--showpower**

  Show current average or instant socket graphics package power consumption

- **-t**, **--showtemp**

  Show current temperature

- **-u**, **--showuse**

  Show current GPU use

- **--showmemuse**

  Show current GPU memory used

- **--showvoltage**

  Show current GPU voltage

### Software-related/controlled information:

- **-b**, **--showbw**

  Show estimated PCIe use

- **-c**, **--showclocks**

  Show current clock frequencies

- **-g**, **--showgpuclocks**

  Show current GPU clock frequencies

- **-l**, **--showprofile**

  Show Compute Profile attributes

- **-M**, **--showmaxpower**

  Show maximum graphics package power this GPU will consume

- **-m**, **--showmemoverdrive**

  Show current GPU Memory Clock OverDrive level

- **-o**, **--showoverdrive**

  Show current GPU Clock OverDrive level

- **-p**, **--showperflevel**

  Show current DPM Performance Level

- **-S**, **--showclkvolt**

  Show supported GPU and Memory Clocks and Voltages

- **-s**, **--showclkfrq**

  Show supported GPU and Memory Clock

- **--showmeminfo** TYPE \[TYPE ...\]

  Show Memory usage information for given block(s) TYPE

- **--showpids** \[VERBOSE\]

  Show current running KFD PIDs (pass details to VERBOSE for detailed information)

- **--showpidgpus** \[SHOWPIDGPUS ...\]

  Show GPUs used by specified KFD PIDs (all if no arg given)

- **--showreplaycount**

  Show PCIe Replay Count

- **--showrasinfo** \[SHOWRASINFO ...\]

  Show RAS enablement information and error counts for the specified block(s) (all if no arg given)

- **--showvc**

  Show voltage curve

- **--showxgmierr**

  Show XGMI error information since last read

- **--showtopo**

  Show hardware topology information

- **--showtopoaccess**

  Shows the link accessibility between GPUs

- **--showtopoweight**

  Shows the relative weight between GPUs

- **--showtopohops**

  Shows the number of hops between GPUs

- **--showtopotype**

  Shows the link type between GPUs

- **--showtoponuma**

  Shows the numa nodes

- **--showenergycounter**

  Energy accumulator that stores amount of energy consumed

- **--shownodesbw**

  Shows the numa nodes

- **--showcomputepartition**

  Shows current compute partitioning

- **--showmemorypartition**

  Shows current memory partition

### Set options:

- **--setclock** TYPE LEVEL

  Set Clock Frequency Level(s) for specified clock (requires manual Perf level)

- **--setsclk** LEVEL \[LEVEL ...\]

  Set GPU Clock Frequency Level(s) (requires manual Perf level)

- **--setmclk** LEVEL \[LEVEL ...\]

  Set GPU Memory Clock Frequency Level(s) (requires manual Perf level)

- **--setpcie** LEVEL \[LEVEL ...\]

  Set PCIE Clock Frequency Level(s) (requires manual Perf level)

- **--setslevel** SCLKLEVEL SCLK SVOLT

  Change GPU Clock frequency (MHz) and Voltage (mV) for a specific Level

- **--setmlevel** MCLKLEVEL MCLK MVOLT

  Change GPU Memory clock frequency (MHz) and Voltage for (mV) a specific Level

- **--setvc** POINT SCLK SVOLT

  Change SCLK Voltage Curve (MHz mV) for a specific point

- **--setsrange** SCLKMIN SCLKMAX

  Set min and max SCLK speed

- **--setextremum** min\|max sclk\|mclk CLK

  Set min/max of SCLK/MCLK speed

- **--setmrange** MCLKMIN MCLKMAX

  Set min and max MCLK speed

- **--setfan** LEVEL

  Set GPU Fan Speed (Level or %)

- **--setperflevel** LEVEL

  Set Performance Level

- **--setoverdrive** %

  Set GPU OverDrive level (requires manual\|high Perf level)

- **--setmemoverdrive** %

  Set GPU Memory Overclock OverDrive level (requires manual\|high Perf level)

- **--setpoweroverdrive** WATTS

  Set the maximum GPU power using Power OverDrive in Watts

- **--setprofile** SETPROFILE

  Specify Power Profile level (#) or a quoted string of CUSTOM Profile attributes "# # # #..." (requires manual Perf level)

- **--setperfdeterminism** SCLK

  Set clock frequency limit to get minimal performance variation

- **--setcomputepartition** {CPX,SPX,DPX,TPX,QPX,cpx,spx,dpx,tpx,qpx}

  Set compute partition

- **--setmemorypartition** {NPS1,NPS2,NPS4,NPS8,nps1,nps2,nps4,nps8}

  Set memory partition

- **--rasenable** BLOCK ERRTYPE

  Enable RAS for specified block and error type

- **--rasdisable** BLOCK ERRTYPE

  Disable RAS for specified block and error type

- **--rasinject** BLOCK

  Inject RAS poison for specified block (ONLY WORKS ON UNSECURED BOARDS)

### Reset options:

- **-r**, **--resetclocks**

  Reset clocks and OverDrive to default

- **--resetfans**

  Reset fans to automatic (driver) control

- **--resetprofile**

  Reset Power Profile back to default

- **--resetpoweroverdrive**

  Set the maximum GPU power back to the device default state

- **--resetxgmierr**

  Reset XGMI error count

- **--resetperfdeterminism**

  Disable performance determinism

- **--resetcomputepartition**

  Resets to boot compute partition state

- **--resetmemorypartition**

  Resets to boot memory partition state

### Auto-response options:

- **--autorespond** RESPONSE

  Response to automatically provide for all prompts (NOT RECOMMENDED)

### Output options:

- **--loglevel** LEVEL

  How much output will be printed for what program is doing, one of debug/info/warning/error/critical

- **--json**

  Print output in JSON format

- **--csv**

  Print output in CSV format

## SEE ALSO

The full documentation for **rocm-smi** is maintained as a Texinfo manual.  If the **info** and **rocm-smi** programs are properly installed at your site, the command

-

  **info rocm-smi**

should give you access to the complete manual.