From: Adrián Larumbe Date: Thu, 30 Jan 2025 17:28:09 +0000 (+0000) Subject: Documentation/gpu: Clarify format of driver-specific fidnfo keys X-Git-Tag: v6.15-rc1~120^2~20^2~38 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=3ddf003c7e41c038c877ee4661d4900d5eb05268;p=thirdparty%2Flinux.git Documentation/gpu: Clarify format of driver-specific fidnfo keys This change reflects de facto usage by amdgpu, as exemplified by commit d6530c33a978 ("drm/amdgpu: expose more memory stats in fdinfo"). Cc: Tvrtko Ursulin Acked-by: Tvrtko Ursulin Signed-off-by: Adrián Larumbe Signed-off-by: Boris Brezillon Link: https://patchwork.freedesktop.org/patch/msgid/20250130172851.941597-2-adrian.larumbe@collabora.com --- diff --git a/Documentation/gpu/drm-usage-stats.rst b/Documentation/gpu/drm-usage-stats.rst index b7fc106dad998..63d6b2abe5adf 100644 --- a/Documentation/gpu/drm-usage-stats.rst +++ b/Documentation/gpu/drm-usage-stats.rst @@ -21,7 +21,10 @@ File format specification - File shall contain one key value pair per one line of text. - Colon character (`:`) must be used to delimit keys and values. -- All keys shall be prefixed with `drm-`. +- All standardised keys shall be prefixed with `drm-`. +- Driver-specific keys shall be prefixed with `driver_name-`, where + driver_name should ideally be the same as the `name` field in + `struct drm_driver`, although this is not mandatory. - Whitespace between the delimiter and first non-whitespace character shall be ignored when parsing. - Keys are not allowed to contain whitespace characters.