leandrof/linux
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

drm/i915/uapi: fix kernel doc warnings

Browse Source 
Fix the cases where it is almost already valid kernel doc, for the
others just nerf the warnings for now.

Signed-off-by: Matthew Auld <matthew.auld@intel.com>
Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Daniel Vetter <daniel.vetter@intel.com>
Cc: Kenneth Graunke <kenneth@whitecape.org>
Cc: Jason Ekstrand <jason@jlekstrand.net>
Cc: Dave Airlie <airlied@gmail.com>
Cc: dri-devel@lists.freedesktop.org
Cc: mesa-dev@lists.freedesktop.org
Reviewed-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Link: https://patchwork.freedesktop.org/patch/msgid/20210419105741.27844-1-matthew.auld@intel.com
This commit is contained in:
Matthew Auld 2021-04-19 11:57:38 +01:00
parent 399cd97970
commit 2ef6a01fb6
1 changed files with 16 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
include/uapi/drm/i915_drm.h
View File

@ -1054,12 +1054,12 @@ struct drm_i915_gem_exec_fence {
__u32 flags; __u32 flags;
}; };
/** /*
* See drm_i915_gem_execbuffer_ext_timeline_fences. * See drm_i915_gem_execbuffer_ext_timeline_fences.
*/ */
#define DRM_I915_GEM_EXECBUFFER_EXT_TIMELINE_FENCES 0 #define DRM_I915_GEM_EXECBUFFER_EXT_TIMELINE_FENCES 0
/** /*
* This structure describes an array of drm_syncobj and associated points for * This structure describes an array of drm_syncobj and associated points for
* timeline variants of drm_syncobj. It is invalid to append this structure to * timeline variants of drm_syncobj. It is invalid to append this structure to
* the execbuf if I915_EXEC_FENCE_ARRAY is set. * the execbuf if I915_EXEC_FENCE_ARRAY is set.
@ -1700,7 +1700,7 @@ struct drm_i915_gem_context_param {
__u64 value; __u64 value;
}; };
/** /*
* Context SSEU programming * Context SSEU programming
* *
* It may be necessary for either functional or performance reason to configure * It may be necessary for either functional or performance reason to configure
@ -2067,7 +2067,7 @@ struct drm_i915_perf_open_param {
__u64 properties_ptr; __u64 properties_ptr;
}; };
/** /*
* Enable data capture for a stream that was either opened in a disabled state * Enable data capture for a stream that was either opened in a disabled state
* via I915_PERF_FLAG_DISABLED or was later disabled via * via I915_PERF_FLAG_DISABLED or was later disabled via
* I915_PERF_IOCTL_DISABLE. * I915_PERF_IOCTL_DISABLE.
@ -2081,7 +2081,7 @@ struct drm_i915_perf_open_param {
*/ */
#define I915_PERF_IOCTL_ENABLE _IO('i', 0x0) #define I915_PERF_IOCTL_ENABLE _IO('i', 0x0)
/** /*
* Disable data capture for a stream. * Disable data capture for a stream.
* *
* It is an error to try and read a stream that is disabled. * It is an error to try and read a stream that is disabled.
@ -2090,7 +2090,7 @@ struct drm_i915_perf_open_param {
*/ */
#define I915_PERF_IOCTL_DISABLE _IO('i', 0x1) #define I915_PERF_IOCTL_DISABLE _IO('i', 0x1)
/** /*
* Change metrics_set captured by a stream. * Change metrics_set captured by a stream.
* *
* If the stream is bound to a specific context, the configuration change * If the stream is bound to a specific context, the configuration change
@ -2103,7 +2103,7 @@ struct drm_i915_perf_open_param {
*/ */
#define I915_PERF_IOCTL_CONFIG _IO('i', 0x2) #define I915_PERF_IOCTL_CONFIG _IO('i', 0x2)
/** /*
* Common to all i915 perf records * Common to all i915 perf records
*/ */
struct drm_i915_perf_record_header { struct drm_i915_perf_record_header {
@ -2151,7 +2151,7 @@ enum drm_i915_perf_record_type {
DRM_I915_PERF_RECORD_MAX /* non-ABI */ DRM_I915_PERF_RECORD_MAX /* non-ABI */
}; };
/** /*
* Structure to upload perf dynamic configuration into the kernel. * Structure to upload perf dynamic configuration into the kernel.
*/ */
struct drm_i915_perf_oa_config { struct drm_i915_perf_oa_config {
@ -2292,21 +2292,21 @@ struct drm_i915_query_topology_info {
* Describes one engine and it's capabilities as known to the driver. * Describes one engine and it's capabilities as known to the driver.
*/ */
struct drm_i915_engine_info { struct drm_i915_engine_info {
/** Engine class and instance. */ /** @engine: Engine class and instance. */
struct i915_engine_class_instance engine; struct i915_engine_class_instance engine;
/** Reserved field. */ /** @rsvd0: Reserved field. */
__u32 rsvd0; __u32 rsvd0;
/** Engine flags. */ /** @flags: Engine flags. */
__u64 flags; __u64 flags;
/** Capabilities of this engine. */ /** @capabilities: Capabilities of this engine. */
__u64 capabilities; __u64 capabilities;
#define I915_VIDEO_CLASS_CAPABILITY_HEVC (1 << 0) #define I915_VIDEO_CLASS_CAPABILITY_HEVC (1 << 0)
#define I915_VIDEO_AND_ENHANCE_CLASS_CAPABILITY_SFC (1 << 1) #define I915_VIDEO_AND_ENHANCE_CLASS_CAPABILITY_SFC (1 << 1)
/** Reserved fields. */ /** @rsvd1: Reserved fields. */
__u64 rsvd1[4]; __u64 rsvd1[4];
}; };
@ -2317,13 +2317,13 @@ struct drm_i915_engine_info {
* an array of struct drm_i915_engine_info structures. * an array of struct drm_i915_engine_info structures.
*/ */
struct drm_i915_query_engine_info { struct drm_i915_query_engine_info {
/** Number of struct drm_i915_engine_info structs following. */ /** @num_engines: Number of struct drm_i915_engine_info structs following. */
__u32 num_engines; __u32 num_engines;
/** MBZ */ /** @rsvd: MBZ */
__u32 rsvd[3]; __u32 rsvd[3];
/** Marker for drm_i915_engine_info structures. */ /** @engines: Marker for drm_i915_engine_info structures. */
struct drm_i915_engine_info engines[]; struct drm_i915_engine_info engines[];
}; };