mirror of
https://github.com/torvalds/linux.git
synced 2026-04-26 02:22:28 -04:00
6282995188
The GuC scheduler ABI header contains a file-level comment that is not intended to document a kernel-doc symbol. Using kernel-doc comment syntax (/** */) triggers kernel-doc warnings. With "-Werror", this causes the build to fail. Convert the comment to a regular block comment. HDRTEST drivers/gpu/drm/xe/abi/guc_scheduler_abi.h Warning: drivers/gpu/drm/xe/abi/guc_scheduler_abi.h:11 This comment starts with '/**', but isn't a kernel-doc comment. Refer to Documentation/doc-guide/kernel-doc.rst * Generic defines required for registration with and submissions to the GuC 1 warnings as errors make[6]: *** [drivers/gpu/drm/xe/Makefile:377: drivers/gpu/drm/xe/abi/guc_scheduler_abi.hdrtest] Error 3 make[5]: *** [scripts/Makefile.build:544: drivers/gpu/drm/xe] Error 2 make[4]: *** [scripts/Makefile.build:544: drivers/gpu/drm] Error 2 make[3]: *** [scripts/Makefile.build:544: drivers/gpu] Error 2 make[2]: *** [scripts/Makefile.build:544: drivers] Error 2 make[1]: *** [/home/kbuild2/kernel/Makefile:2088: .] Error 2 make: *** [Makefile:248: __sub-make] Error 2 v2: - Add Fixes tag (Daniele) Fixes:b0c5cf4f59("drm/gt/guc: extract scheduler-related defines from guc_fwif.h") Signed-off-by: Chaitanya Kumar Borah <chaitanya.kumar.borah@intel.com> Reviewed-by: Shuicheng Lin <shuicheng.lin@intel.com> Reviewed-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com> Signed-off-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com> Link: https://patch.msgid.link/20260130135210.2659200-1-chaitanya.kumar.borah@intel.com (cherry picked from commitf89dbe14a0) Signed-off-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
58 lines
1.5 KiB
C
58 lines
1.5 KiB
C
/* SPDX-License-Identifier: MIT */
|
|
/*
|
|
* Copyright © 2025 Intel Corporation
|
|
*/
|
|
|
|
#ifndef _ABI_GUC_SCHEDULER_ABI_H
|
|
#define _ABI_GUC_SCHEDULER_ABI_H
|
|
|
|
#include <linux/types.h>
|
|
|
|
/*
|
|
* Generic defines required for registration with and submissions to the GuC
|
|
* scheduler. Includes engine class/instance defines and context attributes
|
|
* (id, priority, etc)
|
|
*/
|
|
|
|
/* Engine classes/instances */
|
|
#define GUC_RENDER_CLASS 0
|
|
#define GUC_VIDEO_CLASS 1
|
|
#define GUC_VIDEOENHANCE_CLASS 2
|
|
#define GUC_BLITTER_CLASS 3
|
|
#define GUC_COMPUTE_CLASS 4
|
|
#define GUC_GSC_OTHER_CLASS 5
|
|
#define GUC_LAST_ENGINE_CLASS GUC_GSC_OTHER_CLASS
|
|
#define GUC_MAX_ENGINE_CLASSES 16
|
|
#define GUC_MAX_INSTANCES_PER_CLASS 32
|
|
|
|
/* context priority values */
|
|
#define GUC_CLIENT_PRIORITY_KMD_HIGH 0
|
|
#define GUC_CLIENT_PRIORITY_HIGH 1
|
|
#define GUC_CLIENT_PRIORITY_KMD_NORMAL 2
|
|
#define GUC_CLIENT_PRIORITY_NORMAL 3
|
|
#define GUC_CLIENT_PRIORITY_NUM 4
|
|
|
|
/* Context registration */
|
|
#define GUC_ID_MAX 65535
|
|
#define GUC_ID_UNKNOWN 0xffffffff
|
|
|
|
#define CONTEXT_REGISTRATION_FLAG_KMD BIT(0)
|
|
#define CONTEXT_REGISTRATION_FLAG_TYPE GENMASK(2, 1)
|
|
#define GUC_CONTEXT_NORMAL 0
|
|
#define GUC_CONTEXT_COMPRESSION_SAVE 1
|
|
#define GUC_CONTEXT_COMPRESSION_RESTORE 2
|
|
#define GUC_CONTEXT_COUNT (GUC_CONTEXT_COMPRESSION_RESTORE + 1)
|
|
|
|
/* context enable/disable */
|
|
#define GUC_CONTEXT_DISABLE 0
|
|
#define GUC_CONTEXT_ENABLE 1
|
|
|
|
/* scheduler groups */
|
|
#define GUC_MAX_SCHED_GROUPS 8
|
|
|
|
struct guc_sched_group {
|
|
u32 engines[GUC_MAX_ENGINE_CLASSES];
|
|
} __packed;
|
|
|
|
#endif
|