Commit 2ef6a01f authored by Matthew Auld's avatar Matthew Auld
Browse files

drm/i915/uapi: fix kernel doc warnings 



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

Signed-off-by: default avatarMatthew 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: default avatarDaniel Vetter <daniel.vetter@ffwll.ch>
Link: https://patchwork.freedesktop.org/patch/msgid/20210419105741.27844-1-matthew.auld@intel.com
parent 399cd979

include/uapi/drm/i915_drm.h

+16 −16
Original line number Diff line number Diff line
@@ -1054,12 +1054,12 @@ struct drm_i915_gem_exec_fence { 
	__u32 flags;

};



/**

/*

 * See drm_i915_gem_execbuffer_ext_timeline_fences.

 */

#define DRM_I915_GEM_EXECBUFFER_EXT_TIMELINE_FENCES 0



/**

/*

 * 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

 * the execbuf if I915_EXEC_FENCE_ARRAY is set.
@@ -1700,7 +1700,7 @@ struct drm_i915_gem_context_param { 
	__u64 value;

};



/**

/*

 * Context SSEU programming

 *

 * 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;

};



/**

/*

 * Enable data capture for a stream that was either opened in a disabled state

 * via I915_PERF_FLAG_DISABLED or was later disabled via

 * I915_PERF_IOCTL_DISABLE.
@@ -2081,7 +2081,7 @@ struct drm_i915_perf_open_param { 
 */

#define I915_PERF_IOCTL_ENABLE	_IO('i', 0x0)



/**

/*

 * Disable data capture for a stream.

 *

 * 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)



/**

/*

 * Change metrics_set captured by a stream.

 *

 * 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)



/**

/*

 * Common to all i915 perf records

 */

struct drm_i915_perf_record_header {
@@ -2151,7 +2151,7 @@ enum drm_i915_perf_record_type { 
	DRM_I915_PERF_RECORD_MAX /* non-ABI */

};



/**

/*

 * Structure to upload perf dynamic configuration into the kernel.

 */

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.

 */

struct drm_i915_engine_info {

	/** Engine class and instance. */

	/** @engine: Engine class and instance. */

	struct i915_engine_class_instance engine;



	/** Reserved field. */

	/** @rsvd0: Reserved field. */

	__u32 rsvd0;



	/** Engine flags. */

	/** @flags: Engine flags. */

	__u64 flags;



	/** Capabilities of this engine. */

	/** @capabilities: Capabilities of this engine. */

	__u64 capabilities;

#define I915_VIDEO_CLASS_CAPABILITY_HEVC		(1 << 0)

#define I915_VIDEO_AND_ENHANCE_CLASS_CAPABILITY_SFC	(1 << 1)



	/** Reserved fields. */

	/** @rsvd1: Reserved fields. */

	__u64 rsvd1[4];

};
@@ -2317,13 +2317,13 @@ struct drm_i915_engine_info { 
 * an array of struct drm_i915_engine_info structures.

 */

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;



	/** MBZ */

	/** @rsvd: MBZ */

	__u32 rsvd[3];



	/** Marker for drm_i915_engine_info structures. */

	/** @engines: Marker for drm_i915_engine_info structures. */

	struct drm_i915_engine_info engines[];

};