drivers/gpu/drm/drm_connector.c:2215: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_hdmi_colorspace_property'

From: kernel test robot
Date: Thu Aug 17 2023 - 03:15:42 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 4853c74bd7ab7fdb83f319bd9ace8a08c031e9b6
commit: c265f340eaa87aa5f979adfb23d7463af67b7f27 drm/connector: Allow drivers to pass list of supported colorspaces
date: 10 weeks ago
config: sh-randconfig-r001-20230817 (https://download.01.org/0day-ci/archive/20230817/202308171526.DciyDwCK-lkp@xxxxxxxxx/config)
compiler: sh4-linux-gcc (GCC) 12.3.0
reproduce: (https://download.01.org/0day-ci/archive/20230817/202308171526.DciyDwCK-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202308171526.DciyDwCK-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/drm_connector.c:2215: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_hdmi_colorspace_property'
>> drivers/gpu/drm/drm_connector.c:2239: warning: Function parameter or member 'supported_colorspaces' not described in 'drm_mode_create_dp_colorspace_property'


vim +2215 drivers/gpu/drm/drm_connector.c

c627087cb164d1 Harry Wentland 2022-11-29 2202
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2203 /**
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2204 * drm_mode_create_hdmi_colorspace_property - create hdmi colorspace property
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2205 * @connector: connector to create the Colorspace property on.
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2206 *
d2c6a405846c24 Uma Shankar 2019-02-19 2207 * Called by a driver the first time it's needed, must be attached to desired
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2208 * HDMI connectors.
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2209 *
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2210 * Returns:
84e543bc9d1dc5 Antonio Borneo 2020-06-26 2211 * Zero on success, negative errno on failure.
d2c6a405846c24 Uma Shankar 2019-02-19 2212 */
c265f340eaa87a Harry Wentland 2022-11-29 2213 int drm_mode_create_hdmi_colorspace_property(struct drm_connector *connector,
c265f340eaa87a Harry Wentland 2022-11-29 2214 u32 supported_colorspaces)
d2c6a405846c24 Uma Shankar 2019-02-19 @2215 {
c265f340eaa87a Harry Wentland 2022-11-29 2216 u32 colorspaces;
c265f340eaa87a Harry Wentland 2022-11-29 2217
c265f340eaa87a Harry Wentland 2022-11-29 2218 if (supported_colorspaces)
c265f340eaa87a Harry Wentland 2022-11-29 2219 colorspaces = supported_colorspaces & hdmi_colorspaces;
c265f340eaa87a Harry Wentland 2022-11-29 2220 else
c265f340eaa87a Harry Wentland 2022-11-29 2221 colorspaces = hdmi_colorspaces;
c265f340eaa87a Harry Wentland 2022-11-29 2222
c265f340eaa87a Harry Wentland 2022-11-29 2223 return drm_mode_create_colorspace_property(connector, colorspaces);
d2c6a405846c24 Uma Shankar 2019-02-19 2224 }
8806cd3aa025ad Gwan-gyeong Mun 2019-09-19 2225 EXPORT_SYMBOL(drm_mode_create_hdmi_colorspace_property);
d2c6a405846c24 Uma Shankar 2019-02-19 2226
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2227 /**
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2228 * drm_mode_create_dp_colorspace_property - create dp colorspace property
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2229 * @connector: connector to create the Colorspace property on.
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2230 *
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2231 * Called by a driver the first time it's needed, must be attached to desired
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2232 * DP connectors.
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2233 *
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2234 * Returns:
84e543bc9d1dc5 Antonio Borneo 2020-06-26 2235 * Zero on success, negative errno on failure.
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2236 */
c265f340eaa87a Harry Wentland 2022-11-29 2237 int drm_mode_create_dp_colorspace_property(struct drm_connector *connector,
c265f340eaa87a Harry Wentland 2022-11-29 2238 u32 supported_colorspaces)
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 @2239 {
c265f340eaa87a Harry Wentland 2022-11-29 2240 u32 colorspaces;
c265f340eaa87a Harry Wentland 2022-11-29 2241
c265f340eaa87a Harry Wentland 2022-11-29 2242 if (supported_colorspaces)
c265f340eaa87a Harry Wentland 2022-11-29 2243 colorspaces = supported_colorspaces & dp_colorspaces;
c265f340eaa87a Harry Wentland 2022-11-29 2244 else
c265f340eaa87a Harry Wentland 2022-11-29 2245 colorspaces = dp_colorspaces;
c265f340eaa87a Harry Wentland 2022-11-29 2246
c265f340eaa87a Harry Wentland 2022-11-29 2247 return drm_mode_create_colorspace_property(connector, colorspaces);
d2c6a405846c24 Uma Shankar 2019-02-19 2248 }
45cf0e91df8c75 Gwan-gyeong Mun 2019-09-19 2249 EXPORT_SYMBOL(drm_mode_create_dp_colorspace_property);
d2c6a405846c24 Uma Shankar 2019-02-19 2250

:::::: The code at line 2215 was first introduced by commit
:::::: d2c6a405846c24439f85c7a8da21545f12874638 drm: Add HDMI colorspace property

:::::: TO: Uma Shankar <uma.shankar@xxxxxxxxx>
:::::: CC: Maarten Lankhorst <maarten.lankhorst@xxxxxxxxxxxxxxx>

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki