Commit f780ef56 authored by Adrián Larumbe's avatar Adrián Larumbe Committed by Boris Brezillon
Browse files

Documentation/gpu: Add fdinfo meanings of panthor-*-memory tags 



A previous commit enabled display of driver-internal kernel BO sizes
through the device file's fdinfo interface.

Expand the description of the relevant driver-specific key:value pairs
with the definitions of the new panthor-*-memory ones.

Reviewed-by: default avatarMihail Atanassov <mihail.atanassov@arm.com>
Reviewed-by: default avatarLiviu Dudau <liviu.dudau@arm.com>
Reviewed-by: default avatarSteven Price <steven.price@arm.com>
Signed-off-by: default avatarAdrián Larumbe <adrian.larumbe@collabora.com>
Signed-off-by: default avatarBoris Brezillon <boris.brezillon@collabora.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20250130172851.941597-5-adrian.larumbe@collabora.com
parent 434e5ca5

Documentation/gpu/panthor.rst

+10 −0
Original line number Diff line number Diff line
@@ -26,6 +26,8 @@ the currently possible format options: 
     drm-cycles-panthor:     94439687187

     drm-maxfreq-panthor:    1000000000 Hz

     drm-curfreq-panthor:    1000000000 Hz

     panthor-resident-memory:        10396 KiB

     panthor-active-memory:  10396 KiB

     drm-total-memory:       16480 KiB

     drm-shared-memory:      0

     drm-active-memory:      16200 KiB
@@ -44,3 +46,11 @@ driver by writing into the appropriate sysfs node:: 


Where `N` is a bit mask where cycle and timestamp sampling are respectively

enabled by the first and second bits.



Possible `panthor-*-memory` keys are: `active` and `resident`.

These values convey the sizes of the internal driver-owned shmem BO's that

aren't exposed to user-space through a DRM handle, like queue ring buffers,

sync object arrays and heap chunks. Because they are all allocated and pinned

at creation time, only `panthor-resident-memory` is necessary to tell us their

size. `panthor-active-memory` shows the size of kernel BO's associated with

VM's and groups currently being scheduled for execution by the GPU.