History

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.

Matthew Auld committed 5 years ago

Commit 2ef6a011 parent 399cd971 file · +16 −16Browse files

Showing the changes to include/uapi (1 of 1 file). Show all

Unified · Split

include/uapi/drm/i915_drm.h+16−16
@@ -1054,12 +1054,12 @@ struct drm_i915_gem_exec_fence { · 1053 unmodified lines
1054 __u32 flags;1054 __u32 flags;
1055};1055};
1056 1056
1057/**1057/*
1058 * See drm_i915_gem_execbuffer_ext_timeline_fences.1058 * See drm_i915_gem_execbuffer_ext_timeline_fences.
1059 */1059 */
1060#define DRM_I915_GEM_EXECBUFFER_EXT_TIMELINE_FENCES 01060#define DRM_I915_GEM_EXECBUFFER_EXT_TIMELINE_FENCES 0
1061 1061
1062/**1062/*
1063 * This structure describes an array of drm_syncobj and associated points for1063 * This structure describes an array of drm_syncobj and associated points for
1064 * timeline variants of drm_syncobj. It is invalid to append this structure to1064 * timeline variants of drm_syncobj. It is invalid to append this structure to
1065 * the execbuf if I915_EXEC_FENCE_ARRAY is set.1065 * the execbuf if I915_EXEC_FENCE_ARRAY is set.
@@ -1700,7 +1700,7 @@ struct drm_i915_gem_context_param { · 634 unmodified lines
1700 __u64 value;1700 __u64 value;
1701};1701};
1702 1702
1703/**1703/*
1704 * Context SSEU programming1704 * Context SSEU programming
1705 *1705 *
1706 * It may be necessary for either functional or performance reason to configure1706 * It may be necessary for either functional or performance reason to configure
@@ -2067,7 +2067,7 @@ struct drm_i915_perf_open_param { · 360 unmodified lines
2067 __u64 properties_ptr;2067 __u64 properties_ptr;
2068};2068};
2069 2069
2070/**2070/*
2071 * Enable data capture for a stream that was either opened in a disabled state2071 * Enable data capture for a stream that was either opened in a disabled state
2072 * via I915_PERF_FLAG_DISABLED or was later disabled via2072 * via I915_PERF_FLAG_DISABLED or was later disabled via
2073 * I915_PERF_IOCTL_DISABLE.2073 * I915_PERF_IOCTL_DISABLE.
@@ -2081,7 +2081,7 @@ struct drm_i915_perf_open_param { · 7 unmodified lines
2081 */2081 */
2082#define I915_PERF_IOCTL_ENABLE _IO('i', 0x0)2082#define I915_PERF_IOCTL_ENABLE _IO('i', 0x0)
2083 2083
2084/**2084/*
2085 * Disable data capture for a stream.2085 * Disable data capture for a stream.
2086 *2086 *
2087 * It is an error to try and read a stream that is disabled.2087 * It is an error to try and read a stream that is disabled.
@@ -2090,7 +2090,7 @@ struct drm_i915_perf_open_param { · 2 unmodified lines
2090 */2090 */
2091#define I915_PERF_IOCTL_DISABLE _IO('i', 0x1)2091#define I915_PERF_IOCTL_DISABLE _IO('i', 0x1)
2092 2092
2093/**2093/*
2094 * Change metrics_set captured by a stream.2094 * Change metrics_set captured by a stream.
2095 *2095 *
2096 * If the stream is bound to a specific context, the configuration change2096 * If the stream is bound to a specific context, the configuration change
@@ -2103,7 +2103,7 @@ struct drm_i915_perf_open_param { · 6 unmodified lines
2103 */2103 */
2104#define I915_PERF_IOCTL_CONFIG _IO('i', 0x2)2104#define I915_PERF_IOCTL_CONFIG _IO('i', 0x2)
2105 2105
2106/**2106/*
2107 * Common to all i915 perf records2107 * Common to all i915 perf records
2108 */2108 */
2109struct drm_i915_perf_record_header {2109struct drm_i915_perf_record_header {
@@ -2151,7 +2151,7 @@ enum drm_i915_perf_record_type { · 41 unmodified lines
2151 DRM_I915_PERF_RECORD_MAX /* non-ABI */2151 DRM_I915_PERF_RECORD_MAX /* non-ABI */
2152};2152};
2153 2153
2154/**2154/*
2155 * Structure to upload perf dynamic configuration into the kernel.2155 * Structure to upload perf dynamic configuration into the kernel.
2156 */2156 */
2157struct drm_i915_perf_oa_config {2157struct drm_i915_perf_oa_config {
@@ -2292,21 +2292,21 @@ struct drm_i915_query_topology_info { · 134 unmodified lines
2292 * Describes one engine and it's capabilities as known to the driver.2292 * Describes one engine and it's capabilities as known to the driver.
2293 */2293 */
2294struct drm_i915_engine_info {2294struct drm_i915_engine_info {
2295 /** Engine class and instance. */2295 /** @engine: Engine class and instance. */
2296 struct i915_engine_class_instance engine;2296 struct i915_engine_class_instance engine;
2297 2297
2298 /** Reserved field. */2298 /** @rsvd0: Reserved field. */
2299 __u32 rsvd0;2299 __u32 rsvd0;
2300 2300
2301 /** Engine flags. */2301 /** @flags: Engine flags. */
2302 __u64 flags;2302 __u64 flags;
2303 2303
2304 /** Capabilities of this engine. */2304 /** @capabilities: Capabilities of this engine. */
2305 __u64 capabilities;2305 __u64 capabilities;
2306#define I915_VIDEO_CLASS_CAPABILITY_HEVC (1 << 0)2306#define I915_VIDEO_CLASS_CAPABILITY_HEVC (1 << 0)
2307#define I915_VIDEO_AND_ENHANCE_CLASS_CAPABILITY_SFC (1 << 1)2307#define I915_VIDEO_AND_ENHANCE_CLASS_CAPABILITY_SFC (1 << 1)
2308 2308
2309 /** Reserved fields. */2309 /** @rsvd1: Reserved fields. */
2310 __u64 rsvd1[4];2310 __u64 rsvd1[4];
2311};2311};
2312 2312
@@ -2317,13 +2317,13 @@ struct drm_i915_engine_info { · 4 unmodified lines
2317 * an array of struct drm_i915_engine_info structures.2317 * an array of struct drm_i915_engine_info structures.
2318 */2318 */
2319struct drm_i915_query_engine_info {2319struct drm_i915_query_engine_info {
2320 /** Number of struct drm_i915_engine_info structs following. */2320 /** @num_engines: Number of struct drm_i915_engine_info structs following. */
2321 __u32 num_engines;2321 __u32 num_engines;
2322 2322
2323 /** MBZ */2323 /** @rsvd: MBZ */
2324 __u32 rsvd[3];2324 __u32 rsvd[3];
2325 2325
2326 /** Marker for drm_i915_engine_info structures. */2326 /** @engines: Marker for drm_i915_engine_info structures. */
2327 struct drm_i915_engine_info engines[];2327 struct drm_i915_engine_info engines[];
2328};2328};
2329 2329