intel_gpu_top(1)            General Commands Manual           intel_gpu_top(1)

<?><?><?> (NAME)
       intel_gpu_top - <?><?><?><?><?><?> <?><?><?><?><?> top <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       intel_gpu_top [<?><?><?><?><?><?><?><?>]

<?><?><?><?><?><?><?> (DESCRIPTION)
       intel_gpu_top <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> (Intel GPU) <?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (PMU) <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> i915 <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> RAPL (<?><?><?><?> <?><?><?><?><?>) <?> Uncore IMC
       (<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>) <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)

       -h     <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

       -c     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> CSV.

       -J     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> JSON.

       -l     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.

       -o <file> <?><?> -o -
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> '-' <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       -s <ms>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>.

       -L     <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       -d     <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?>.

       -p     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.

       -m     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?>.

       -n <number>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <refresh period> * <number - 1>
              <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?> 0
              (<?><?><?><?><?><?><?>) <?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> q <?><?> Ctrl-C <?><?> <?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?>. <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              -c<?> -J <?><?> -l<?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <number> <?><?><?> <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> (RUNTIME CONTROL)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>:

         'q'    <?><?><?><?> <?><?> <?><?><?><?><?>.
         'h'    <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
         '1'    <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
         'n'    <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
         's'    <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (runtime<?> total runtime<?> pid<?> client id).
         'i'    <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> GPU <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
         'H'    <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> PID <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.
         'm'    <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (DEVICE SELECTION)
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (GPU) <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> sysfs<?> <?><?><?> <?><?><?><?><?><?>
       drm <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> PCI <?><?><?><?><?><?> <?><?><?>.

+----------------+------------------------------------------------+--------------------------------+
|<?><?><?><?><?> | <?><?><?>                                      | <?><?><?><?><?>                |
|                |                                                | <?><?><?><?><?><?> GPU         |
+----------------+------------------------------------------------+--------------------------------+
|sys             | sys:/sys/devices/pci0000:00/0000:00:02.0       | <?><?><?><?><?><?> <?><?>      |
|                |                                                | <?><?><?><?><?><?><?> <?><?>   |
|                |                                                | <?><?><?><?> sysfs.            |
+----------------+------------------------------------------------+--------------------------------+
|drm             | drm:/dev/dri/<node>                            | <?><?><?><?><?><?> <?><?>      |
|                |                                                | <?><?><?><?><?><?><?> <?><?>   |
|                |                                                | <?><?><?> <?><?><?><?><?><?>   |
|                |                                                | /dev/dri/*.                    |
+----------------+------------------------------------------------+--------------------------------+
|pci             | pci:[vendor=%04x/name][,device=%04x][,card=%d] | <?><?><?><?><?><?> <?><?>      |
|                |                                                | <?><?><?><?><?><?><?> <?><?>   |
|                |                                                | <?><?><?><?><?> PCI.           |
|                |                                                | <?><?><?><?><?><?> (Vendor)    |
|                |                                                | <?><?> <?><?><?>               |
|                |                                                | <?><?><?><?><?><?><?><?><?><?> |
|                |                                                | <?><?> <?><?><?>               |
|                |                                                | <?><?><?><?><?><?> <?><?><?>.  |
+----------------+------------------------------------------------+--------------------------------+
<?><?><?><?><?> JSON (JSON OUTPUT)
       <?><?><?><?><?> JSON <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?> (LIMITATIONS)

       o <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
         <?><?><?><?><?><?> Xe <?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?>
         <?><?><?><?><?> gputop <?><?><?><?><?><?><?> <?><?><?><?>.

       o <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?>
         <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
         <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?>
         <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       o <?><?><?><?><?><?> <?><?><?><?><?><?><?> (non-root) <?><?>
         <?><?><?><?><?><?><?><?><?><?><?> perf <?><?><?><?> sysctl <?><?>
         <?><?><?><?><?> perf_event_paranoid <?><?><?><?><?>
         <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?> (BUGS)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> fd.o:
       <https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/issues>

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?><?><?><?><?><?><?><?><?> IGT <igt-
       dev@lists.freedesktop.org>

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       2009,2011,2012,2016,2018,2019,2020,2023,2025 Intel Corporation

igt-gpu-tools 2.5                 2023-01-27                  intel_gpu_top(1)