]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
drm/xe: Document GT statistics
authorFrancois Dugast <francois.dugast@intel.com>
Fri, 27 Mar 2026 20:27:49 +0000 (21:27 +0100)
committerFrancois Dugast <francois.dugast@intel.com>
Mon, 30 Mar 2026 09:00:45 +0000 (11:00 +0200)
commitdf03d7c2bbc91d1e83f8b42881ad791353df7d94
treeee0d6472eb986cec948e18aaaa9a7a39f36c7194
parent4a706bd93c4fb156a13477e26ffdf2e633edeb10
drm/xe: Document GT statistics

In the context of porting applications to SVM, the Xe GT statistics are
used by application developers to validate expected behavior such as
proper alignment, page fault count and migrations. As those statistics
are made for kernel developers, they assume good understanding of driver
internals, which is not always the case on the application side.
Therefore, this commit documents the usage of GT statistics and clarifies
the meaning of identifiers which correspond to the values exposed via
debugfs. Documentation is close to identifiers declaration to make it
easier to maintain when adding new entries in the future.

v2: Fix page reclaim list (PRL) entries (Matthew Brost)

Assisted-by: GitHub Copilot:claude-sonnet-4.6
Cc: Matthew Brost <matthew.brost@intel.com>
Reviewed-by: Matthew Brost <matthew.brost@intel.com>
Link: https://lore.kernel.org/r/20260327202749.222794-1-francois.dugast@intel.com
Signed-off-by: Francois Dugast <francois.dugast@intel.com>
Documentation/gpu/xe/index.rst
Documentation/gpu/xe/xe_gt_stats.rst [new file with mode: 0644]
drivers/gpu/drm/xe/xe_gt_stats.c
drivers/gpu/drm/xe/xe_gt_stats_types.h