History

drm/xe/uapi: Fix kernel-doc cross-reference syntax in xe_drm.h

Fix incorrect kernel-doc cross-reference markup syntax throughout xe_drm.h: - @struct_name -> &struct name for cross-references to other structs (19 occurrences) - struct @name -> &struct name where struct keyword was mixed with @ syntax (8 occurrences) - enum @name -> &enum name for cross-references to other enums (5 occurrences) - &CONSTANT / @CONSTANT -> %CONSTANT for defines and enum values (15 occurrences) - @field references to members of other structs -> plain text, since @ only applies to the current struct's members (9 occurrences) Per kernel-doc conventions (Documentation/doc-guide/kernel-doc.rst): - '&struct name' creates hyperlinks to struct definitions - '&enum name' creates hyperlinks to enum definitions - '%NAME' references constants and defines - '@name' is only for parameters/members of the current context

Shuicheng Lin committed 7 months ago

Commit 4bd87e71 parent ea842c21 file · +53 −53Browse files

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

Unified · Split

include/uapi/drm/xe_drm.h+53−53
@@ -229,9 +229,9 @@ struct drm_xe_ext_set_property { · 228 unmodified lines
229/**229/**
230 * struct drm_xe_engine_class_instance - instance of an engine class230 * struct drm_xe_engine_class_instance - instance of an engine class
231 *231 *
232 * It is returned as part of the @drm_xe_engine, but it also is used as232 * It is returned as part of the &struct drm_xe_engine, but it also is used as
233 * the input of engine selection for both @drm_xe_exec_queue_create and233 * the input of engine selection for both &struct drm_xe_exec_queue_create and
234 * @drm_xe_query_engine_cycles234 * &struct drm_xe_query_engine_cycles
235 *235 *
236 * The @engine_class can be:236 * The @engine_class can be:
237 * - %DRM_XE_ENGINE_CLASS_RENDER237 * - %DRM_XE_ENGINE_CLASS_RENDER
@@ -264,7 +264,7 @@ struct drm_xe_engine_class_instance { · 26 unmodified lines
264 * struct drm_xe_engine - describe hardware engine264 * struct drm_xe_engine - describe hardware engine
265 */265 */
266struct drm_xe_engine {266struct drm_xe_engine {
267 /** @instance: The @drm_xe_engine_class_instance */267 /** @instance: The &struct drm_xe_engine_class_instance */
268 struct drm_xe_engine_class_instance instance;268 struct drm_xe_engine_class_instance instance;
269 269
270 /** @reserved: Reserved */270 /** @reserved: Reserved */
@@ -274,9 +274,9 @@ struct drm_xe_engine { · 3 unmodified lines
274/**274/**
275 * struct drm_xe_query_engines - describe engines275 * struct drm_xe_query_engines - describe engines
276 *276 *
277 * If a query is made with a struct @drm_xe_device_query where .query277 * If a query is made with a &struct drm_xe_device_query where .query
278 * is equal to %DRM_XE_DEVICE_QUERY_ENGINES, then the reply uses an array of278 * is equal to %DRM_XE_DEVICE_QUERY_ENGINES, then the reply uses an array of
279 * struct @drm_xe_query_engines in .data.279 * &struct drm_xe_query_engines in .data.
280 */280 */
281struct drm_xe_query_engines {281struct drm_xe_query_engines {
282 /** @num_engines: number of engines returned in @engines */282 /** @num_engines: number of engines returned in @engines */
@@ -825,7 +825,7 @@ struct drm_xe_device_query { · 542 unmodified lines
825 *825 *
826 * This ioctl supports setting the following properties via the826 * This ioctl supports setting the following properties via the
827 * %DRM_XE_GEM_CREATE_EXTENSION_SET_PROPERTY extension, which uses the827 * %DRM_XE_GEM_CREATE_EXTENSION_SET_PROPERTY extension, which uses the
828 * generic @drm_xe_ext_set_property struct:828 * generic &struct drm_xe_ext_set_property:
829 *829 *
830 * - %DRM_XE_GEM_CREATE_SET_PROPERTY_PXP_TYPE - set the type of PXP session830 * - %DRM_XE_GEM_CREATE_SET_PROPERTY_PXP_TYPE - set the type of PXP session
831 * this object will be used with. Valid values are listed in enum831 * this object will be used with. Valid values are listed in enum
@@ -1198,10 +1198,10 @@ struct drm_xe_vm_bind_op { · 366 unmodified lines
1198/**1198/**
1199 * struct drm_xe_vm_bind - Input of &DRM_IOCTL_XE_VM_BIND1199 * struct drm_xe_vm_bind - Input of &DRM_IOCTL_XE_VM_BIND
1200 *1200 *
1201 * Below is an example of a minimal use of @drm_xe_vm_bind to1201 * Below is an example of a minimal use of &struct drm_xe_vm_bind to
1202 * asynchronously bind the buffer `data` at address `BIND_ADDRESS` to1202 * asynchronously bind the buffer `data` at address `BIND_ADDRESS` to
1203 * illustrate `userptr`. It can be synchronized by using the example1203 * illustrate `userptr`. It can be synchronized by using the example
1204 * provided for @drm_xe_sync.1204 * provided for &struct drm_xe_sync.
1205 *1205 *
1206 * .. code-block:: C1206 * .. code-block:: C
1207 *1207 *
@@ -1354,7 +1354,7 @@ struct drm_xe_vm_get_property { · 146 unmodified lines
1354 *1354 *
1355 * This ioctl supports setting the following properties via the1355 * This ioctl supports setting the following properties via the
1356 * %DRM_XE_EXEC_QUEUE_EXTENSION_SET_PROPERTY extension, which uses the1356 * %DRM_XE_EXEC_QUEUE_EXTENSION_SET_PROPERTY extension, which uses the
1357 * generic @drm_xe_ext_set_property struct:1357 * generic &struct drm_xe_ext_set_property:
1358 *1358 *
1359 * - %DRM_XE_EXEC_QUEUE_SET_PROPERTY_PRIORITY - set the queue priority.1359 * - %DRM_XE_EXEC_QUEUE_SET_PROPERTY_PRIORITY - set the queue priority.
1360 * CAP_SYS_NICE is required to set a value above normal.1360 * CAP_SYS_NICE is required to set a value above normal.
@@ -1389,9 +1389,9 @@ struct drm_xe_vm_get_property { · 28 unmodified lines
1389 * enable render color cache keying on BTP+BTI instead of just BTI1389 * enable render color cache keying on BTP+BTI instead of just BTI
1390 * (only valid for render queues).1390 * (only valid for render queues).
1391 *1391 *
1392 * The example below shows how to use @drm_xe_exec_queue_create to create1392 * The example below shows how to use &struct drm_xe_exec_queue_create to create
1393 * a simple exec_queue (no parallel submission) of class1393 * a simple exec_queue (no parallel submission) of class
1394 * &DRM_XE_ENGINE_CLASS_RENDER.1394 * %DRM_XE_ENGINE_CLASS_RENDER.
1395 *1395 *
1396 * .. code-block:: C1396 * .. code-block:: C
1397 *1397 *
@@ -1514,7 +1514,7 @@ struct drm_xe_exec_queue_get_property { · 116 unmodified lines
1514 * and the @flags can be:1514 * and the @flags can be:
1515 * - %DRM_XE_SYNC_FLAG_SIGNAL1515 * - %DRM_XE_SYNC_FLAG_SIGNAL
1516 *1516 *
1517 * A minimal use of @drm_xe_sync looks like this:1517 * A minimal use of &struct drm_xe_sync looks like this:
1518 *1518 *
1519 * .. code-block:: C1519 * .. code-block:: C
1520 *1520 *
@@ -1580,10 +1580,10 @@ struct drm_xe_sync { · 59 unmodified lines
1580/**1580/**
1581 * struct drm_xe_exec - Input of &DRM_IOCTL_XE_EXEC1581 * struct drm_xe_exec - Input of &DRM_IOCTL_XE_EXEC
1582 *1582 *
1583 * This is an example to use @drm_xe_exec for execution of the object1583 * This is an example to use &struct drm_xe_exec for execution of the object
1584 * at BIND_ADDRESS (see example in @drm_xe_vm_bind) by an exec_queue1584 * at BIND_ADDRESS (see example in &struct drm_xe_vm_bind) by an exec_queue
1585 * (see example in @drm_xe_exec_queue_create). It can be synchronized1585 * (see example in &struct drm_xe_exec_queue_create). It can be synchronized
1586 * by using the example provided for @drm_xe_sync.1586 * by using the example provided for &struct drm_xe_sync.
1587 *1587 *
1588 * .. code-block:: C1588 * .. code-block:: C
1589 *1589 *
@@ -1749,9 +1749,9 @@ enum drm_xe_observation_op { · 159 unmodified lines
1749struct drm_xe_observation_param {1749struct drm_xe_observation_param {
1750 /** @extensions: Pointer to the first extension struct, if any */1750 /** @extensions: Pointer to the first extension struct, if any */
1751 __u64 extensions;1751 __u64 extensions;
1752 /** @observation_type: observation stream type, of enum @drm_xe_observation_type */1752 /** @observation_type: observation stream type, of &enum drm_xe_observation_type */
1753 __u64 observation_type;1753 __u64 observation_type;
1754 /** @observation_op: observation stream op, of enum @drm_xe_observation_op */1754 /** @observation_op: observation stream op, of &enum drm_xe_observation_op */
1755 __u64 observation_op;1755 __u64 observation_op;
1756 /** @param: Pointer to actual stream params */1756 /** @param: Pointer to actual stream params */
1757 __u64 param;1757 __u64 param;
@@ -1810,7 +1810,7 @@ struct drm_xe_oa_unit { · 52 unmodified lines
1810 /** @oa_unit_id: OA unit ID */1810 /** @oa_unit_id: OA unit ID */
1811 __u32 oa_unit_id;1811 __u32 oa_unit_id;
1812 1812
1813 /** @oa_unit_type: OA unit type of @drm_xe_oa_unit_type */1813 /** @oa_unit_type: OA unit type of &enum drm_xe_oa_unit_type */
1814 __u32 oa_unit_type;1814 __u32 oa_unit_type;
1815 1815
1816 /** @capabilities: OA capabilities bit-mask */1816 /** @capabilities: OA capabilities bit-mask */
@@ -1873,7 +1873,7 @@ struct drm_xe_query_oa_units { · 56 unmodified lines
1873 /** @pad: MBZ */1873 /** @pad: MBZ */
1874 __u32 pad;1874 __u32 pad;
1875 /**1875 /**
1876 * @oa_units: struct @drm_xe_oa_unit array returned for this device.1876 * @oa_units: &struct drm_xe_oa_unit array returned for this device.
1877 * Written below as a u64 array to avoid problems with nested flexible1877 * Written below as a u64 array to avoid problems with nested flexible
1878 * arrays with some compilers1878 * arrays with some compilers
1879 */1879 */
@@ -1902,22 +1902,22 @@ enum drm_xe_oa_format_type { · 22 unmodified lines
1902/**1902/**
1903 * enum drm_xe_oa_property_id - OA stream property IDs1903 * enum drm_xe_oa_property_id - OA stream property IDs
1904 *1904 *
1905 * Stream params are specified as a chain of @drm_xe_ext_set_property1905 * Stream params are specified as a chain of &struct drm_xe_ext_set_property
1906 * structs, with @property values from enum @drm_xe_oa_property_id and1906 * structs, with property values from &enum drm_xe_oa_property_id and
1907 * @drm_xe_user_extension base.name set to @DRM_XE_OA_EXTENSION_SET_PROPERTY.1907 * &struct drm_xe_user_extension base.name set to %DRM_XE_OA_EXTENSION_SET_PROPERTY.
1908 * @param field in struct @drm_xe_observation_param points to the first1908 * The param field in &struct drm_xe_observation_param points to the first
1909 * @drm_xe_ext_set_property struct.1909 * &struct drm_xe_ext_set_property struct.
1910 *1910 *
1911 * Exactly the same mechanism is also used for stream reconfiguration using the1911 * Exactly the same mechanism is also used for stream reconfiguration using the
1912 * @DRM_XE_OBSERVATION_IOCTL_CONFIG observation stream fd ioctl, though only a1912 * %DRM_XE_OBSERVATION_IOCTL_CONFIG observation stream fd ioctl, though only a
1913 * subset of properties below can be specified for stream reconfiguration.1913 * subset of properties below can be specified for stream reconfiguration.
1914 */1914 */
1915enum drm_xe_oa_property_id {1915enum drm_xe_oa_property_id {
1916#define DRM_XE_OA_EXTENSION_SET_PROPERTY 01916#define DRM_XE_OA_EXTENSION_SET_PROPERTY 0
1917 /**1917 /**
1918 * @DRM_XE_OA_PROPERTY_OA_UNIT_ID: ID of the OA unit on which to open1918 * @DRM_XE_OA_PROPERTY_OA_UNIT_ID: ID of the OA unit on which to open
1919 * the OA stream, see @oa_unit_id in 'struct1919 * the OA stream, see oa_unit_id in &struct drm_xe_oa_unit.
1920 * drm_xe_oa_unit'. Defaults to 0 if not provided.1920 * Defaults to 0 if not provided.
1921 */1921 */
1922 DRM_XE_OA_PROPERTY_OA_UNIT_ID = 1,1922 DRM_XE_OA_PROPERTY_OA_UNIT_ID = 1,
1923 1923
@@ -1930,7 +1930,7 @@ enum drm_xe_oa_property_id { · 6 unmodified lines
1930 1930
1931 /**1931 /**
1932 * @DRM_XE_OA_PROPERTY_OA_METRIC_SET: OA metrics defining contents of OA1932 * @DRM_XE_OA_PROPERTY_OA_METRIC_SET: OA metrics defining contents of OA
1933 * reports, previously added via @DRM_XE_OBSERVATION_OP_ADD_CONFIG.1933 * reports, previously added via %DRM_XE_OBSERVATION_OP_ADD_CONFIG.
1934 */1934 */
1935 DRM_XE_OA_PROPERTY_OA_METRIC_SET,1935 DRM_XE_OA_PROPERTY_OA_METRIC_SET,
1936 1936
@@ -1938,7 +1938,7 @@ enum drm_xe_oa_property_id { · 1 unmodified line
1938 DRM_XE_OA_PROPERTY_OA_FORMAT,1938 DRM_XE_OA_PROPERTY_OA_FORMAT,
1939 /*1939 /*
1940 * OA_FORMAT's are specified the same way as in PRM/Bspec 52198/60942,1940 * OA_FORMAT's are specified the same way as in PRM/Bspec 52198/60942,
1941 * in terms of the following quantities: a. enum @drm_xe_oa_format_type1941 * in terms of the following quantities: a. &enum drm_xe_oa_format_type
1942 * b. Counter select c. Counter size and d. BC report. Also refer to the1942 * b. Counter select c. Counter size and d. BC report. Also refer to the
1943 * oa_formats array in drivers/gpu/drm/xe/xe_oa.c.1943 * oa_formats array in drivers/gpu/drm/xe/xe_oa.c.
1944 */1944 */
@@ -1955,19 +1955,19 @@ enum drm_xe_oa_property_id { · 10 unmodified lines
1955 1955
1956 /**1956 /**
1957 * @DRM_XE_OA_PROPERTY_OA_DISABLED: A value of 1 will open the OA1957 * @DRM_XE_OA_PROPERTY_OA_DISABLED: A value of 1 will open the OA
1958 * stream in a DISABLED state (see @DRM_XE_OBSERVATION_IOCTL_ENABLE).1958 * stream in a DISABLED state (see %DRM_XE_OBSERVATION_IOCTL_ENABLE).
1959 */1959 */
1960 DRM_XE_OA_PROPERTY_OA_DISABLED,1960 DRM_XE_OA_PROPERTY_OA_DISABLED,
1961 1961
1962 /**1962 /**
1963 * @DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID: Open the stream for a specific1963 * @DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID: Open the stream for a specific
1964 * @exec_queue_id. OA queries can be executed on this exec queue.1964 * exec_queue_id. OA queries can be executed on this exec queue.
1965 */1965 */
1966 DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID,1966 DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID,
1967 1967
1968 /**1968 /**
1969 * @DRM_XE_OA_PROPERTY_OA_ENGINE_INSTANCE: Optional engine instance to1969 * @DRM_XE_OA_PROPERTY_OA_ENGINE_INSTANCE: Optional engine instance to
1970 * pass along with @DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID or will default to 0.1970 * pass along with %DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID or will default to 0.
1971 */1971 */
1972 DRM_XE_OA_PROPERTY_OA_ENGINE_INSTANCE,1972 DRM_XE_OA_PROPERTY_OA_ENGINE_INSTANCE,
1973 1973
@@ -1979,16 +1979,16 @@ enum drm_xe_oa_property_id { · 5 unmodified lines
1979 1979
1980 /**1980 /**
1981 * @DRM_XE_OA_PROPERTY_NUM_SYNCS: Number of syncs in the sync array1981 * @DRM_XE_OA_PROPERTY_NUM_SYNCS: Number of syncs in the sync array
1982 * specified in @DRM_XE_OA_PROPERTY_SYNCS1982 * specified in %DRM_XE_OA_PROPERTY_SYNCS
1983 */1983 */
1984 DRM_XE_OA_PROPERTY_NUM_SYNCS,1984 DRM_XE_OA_PROPERTY_NUM_SYNCS,
1985 1985
1986 /**1986 /**
1987 * @DRM_XE_OA_PROPERTY_SYNCS: Pointer to struct @drm_xe_sync array1987 * @DRM_XE_OA_PROPERTY_SYNCS: Pointer to &struct drm_xe_sync array
1988 * with array size specified via @DRM_XE_OA_PROPERTY_NUM_SYNCS. OA1988 * with array size specified via %DRM_XE_OA_PROPERTY_NUM_SYNCS. OA
1989 * configuration will wait till input fences signal. Output fences1989 * configuration will wait till input fences signal. Output fences
1990 * will signal after the new OA configuration takes effect. For1990 * will signal after the new OA configuration takes effect. For
1991 * @DRM_XE_SYNC_TYPE_USER_FENCE, @addr is a user pointer, similar1991 * %DRM_XE_SYNC_TYPE_USER_FENCE, addr is a user pointer, similar
1992 * to the VM bind case.1992 * to the VM bind case.
1993 */1993 */
1994 DRM_XE_OA_PROPERTY_SYNCS,1994 DRM_XE_OA_PROPERTY_SYNCS,
@@ -2011,9 +2011,9 @@ enum drm_xe_oa_property_id { · 16 unmodified lines
2011/**2011/**
2012 * struct drm_xe_oa_config - OA metric configuration2012 * struct drm_xe_oa_config - OA metric configuration
2013 *2013 *
2014 * Multiple OA configs can be added using @DRM_XE_OBSERVATION_OP_ADD_CONFIG. A2014 * Multiple OA configs can be added using %DRM_XE_OBSERVATION_OP_ADD_CONFIG. A
2015 * particular config can be specified when opening an OA stream using2015 * particular config can be specified when opening an OA stream using
2016 * @DRM_XE_OA_PROPERTY_OA_METRIC_SET property.2016 * %DRM_XE_OA_PROPERTY_OA_METRIC_SET property.
2017 */2017 */
2018struct drm_xe_oa_config {2018struct drm_xe_oa_config {
2019 /** @extensions: Pointer to the first extension struct, if any */2019 /** @extensions: Pointer to the first extension struct, if any */
@@ -2034,7 +2034,7 @@ struct drm_xe_oa_config { · 14 unmodified lines
2034 2034
2035/**2035/**
2036 * struct drm_xe_oa_stream_status - OA stream status returned from2036 * struct drm_xe_oa_stream_status - OA stream status returned from
2037 * @DRM_XE_OBSERVATION_IOCTL_STATUS observation stream fd ioctl. Userspace can2037 * %DRM_XE_OBSERVATION_IOCTL_STATUS observation stream fd ioctl. Userspace can
2038 * call the ioctl to query stream status in response to EIO errno from2038 * call the ioctl to query stream status in response to EIO errno from
2039 * observation fd read().2039 * observation fd read().
2040 */2040 */
@@ -2055,7 +2055,7 @@ struct drm_xe_oa_stream_status { · 14 unmodified lines
2055 2055
2056/**2056/**
2057 * struct drm_xe_oa_stream_info - OA stream info returned from2057 * struct drm_xe_oa_stream_info - OA stream info returned from
2058 * @DRM_XE_OBSERVATION_IOCTL_INFO observation stream fd ioctl2058 * %DRM_XE_OBSERVATION_IOCTL_INFO observation stream fd ioctl
2059 */2059 */
2060struct drm_xe_oa_stream_info {2060struct drm_xe_oa_stream_info {
2061 /** @extensions: Pointer to the first extension struct, if any */2061 /** @extensions: Pointer to the first extension struct, if any */
@@ -2092,27 +2092,27 @@ enum drm_xe_pxp_session_type { · 30 unmodified lines
2092 * enum drm_xe_eu_stall_property_id - EU stall sampling input property ids.2092 * enum drm_xe_eu_stall_property_id - EU stall sampling input property ids.
2093 *2093 *
2094 * These properties are passed to the driver at open as a chain of2094 * These properties are passed to the driver at open as a chain of
2095 * @drm_xe_ext_set_property structures with @property set to these2095 * &struct drm_xe_ext_set_property structures with property set to these
2096 * properties' enums and @value set to the corresponding values of these2096 * properties' enums and value set to the corresponding values of these
2097 * properties. @drm_xe_user_extension base.name should be set to2097 * properties. &struct drm_xe_user_extension base.name should be set to
2098 * @DRM_XE_EU_STALL_EXTENSION_SET_PROPERTY.2098 * %DRM_XE_EU_STALL_EXTENSION_SET_PROPERTY.
2099 *2099 *
2100 * With the file descriptor obtained from open, user space must enable2100 * With the file descriptor obtained from open, user space must enable
2101 * the EU stall stream fd with @DRM_XE_OBSERVATION_IOCTL_ENABLE before2101 * the EU stall stream fd with %DRM_XE_OBSERVATION_IOCTL_ENABLE before
2102 * calling read(). EIO errno from read() indicates HW dropped data2102 * calling read(). EIO errno from read() indicates HW dropped data
2103 * due to full buffer.2103 * due to full buffer.
2104 */2104 */
2105enum drm_xe_eu_stall_property_id {2105enum drm_xe_eu_stall_property_id {
2106#define DRM_XE_EU_STALL_EXTENSION_SET_PROPERTY 02106#define DRM_XE_EU_STALL_EXTENSION_SET_PROPERTY 0
2107 /**2107 /**
2108 * @DRM_XE_EU_STALL_PROP_GT_ID: @gt_id of the GT on which2108 * @DRM_XE_EU_STALL_PROP_GT_ID: gt_id of the GT on which
2109 * EU stall data will be captured.2109 * EU stall data will be captured.
2110 */2110 */
2111 DRM_XE_EU_STALL_PROP_GT_ID = 1,2111 DRM_XE_EU_STALL_PROP_GT_ID = 1,
2112 2112
2113 /**2113 /**
2114 * @DRM_XE_EU_STALL_PROP_SAMPLE_RATE: Sampling rate in2114 * @DRM_XE_EU_STALL_PROP_SAMPLE_RATE: Sampling rate in
2115 * GPU cycles from @sampling_rates in struct @drm_xe_query_eu_stall2115 * GPU cycles from sampling_rates in &struct drm_xe_query_eu_stall
2116 */2116 */
2117 DRM_XE_EU_STALL_PROP_SAMPLE_RATE,2117 DRM_XE_EU_STALL_PROP_SAMPLE_RATE,
2118 2118
@@ -2127,9 +2127,9 @@ enum drm_xe_eu_stall_property_id { · 8 unmodified lines
2127/**2127/**
2128 * struct drm_xe_query_eu_stall - Information about EU stall sampling.2128 * struct drm_xe_query_eu_stall - Information about EU stall sampling.
2129 *2129 *
2130 * If a query is made with a struct @drm_xe_device_query where .query2130 * If a query is made with a &struct drm_xe_device_query where .query
2131 * is equal to @DRM_XE_DEVICE_QUERY_EU_STALL, then the reply uses2131 * is equal to %DRM_XE_DEVICE_QUERY_EU_STALL, then the reply uses
2132 * struct @drm_xe_query_eu_stall in .data.2132 * &struct drm_xe_query_eu_stall in .data.
2133 */2133 */
2134struct drm_xe_query_eu_stall {2134struct drm_xe_query_eu_stall {
2135 /** @extensions: Pointer to the first extension struct, if any */2135 /** @extensions: Pointer to the first extension struct, if any */
@@ -2240,7 +2240,7 @@ struct drm_xe_madvise { · 104 unmodified lines
2240 2240
2241 /**2241 /**
2242 * @preferred_mem_loc.region_instance : Region instance.2242 * @preferred_mem_loc.region_instance : Region instance.
2243 * MBZ if @devmem_fd <= &DRM_XE_PREFERRED_LOC_DEFAULT_DEVICE.2243 * MBZ if @devmem_fd <= %DRM_XE_PREFERRED_LOC_DEFAULT_DEVICE.
2244 * Otherwise should point to the desired device2244 * Otherwise should point to the desired device
2245 * VRAM instance of the device indicated by2245 * VRAM instance of the device indicated by
2246 * @preferred_mem_loc.devmem_fd.2246 * @preferred_mem_loc.devmem_fd.