linux-kernel - drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:247: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202209271704.IqU2wY1B-lkp@intel.com>
Date:   Tue, 27 Sep 2022 17:23:29 +0800
From:   kernel test robot <lkp@...el.com>
To:     George Shen <george.shen@....com>
Cc:     kbuild-all@...ts.01.org, linux-kernel@...r.kernel.org,
        Alex Deucher <alexander.deucher@....com>,
        Alvin Lee <alvin.lee2@....com>,
        Nevenko Stupar <Nevenko.Stupar@....com>,
        linux-doc@...r.kernel.org
Subject: drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:247:
 warning: This comment starts with '/**', but isn't a kernel-doc comment.
 Refer Documentation/doc-guide/kernel-doc.rst

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   a1375562c0a87f0fa2eaf3e8ce15824696d4170a
commit: 056fb8cfbe213f6eb5e987a806583986a4ae8328 drm/amd/display: Update dummy P-state search to use DCN32 DML
date:   6 days ago
config: x86_64-allyesconfig
compiler: gcc-11 (Debian 11.3.0-5) 11.3.0
reproduce (this is a W=1 build):
        # https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=056fb8cfbe213f6eb5e987a806583986a4ae8328
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout 056fb8cfbe213f6eb5e987a806583986a4ae8328
        # save the config file
        mkdir build_dir && cp config build_dir/.config
        make W=1 O=build_dir ARCH=x86_64 SHELL=/bin/bash

If you fix the issue, kindly add following tag where applicable
| Reported-by: kernel test robot <lkp@...el.com>

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:247: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Finds dummy_latency_index when MCLK switching using firmware based
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:484: warning: Function parameter or member 'phantom_stream' not described in 'dcn32_set_phantom_stream_timing'
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:601: warning: Function parameter or member 'dc' not described in 'dcn32_assign_subvp_pipe'
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:601: warning: Function parameter or member 'context' not described in 'dcn32_assign_subvp_pipe'
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:601: warning: Function parameter or member 'index' not described in 'dcn32_assign_subvp_pipe'
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:2140: warning: Function parameter or member 'dc' not described in 'dcn32_update_bw_bounding_box_fpu'
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:2140: warning: Function parameter or member 'bw_params' not described in 'dcn32_update_bw_bounding_box_fpu'
   drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c:2140: warning: expecting prototype for dcn32_update_bw_bounding_box(). Prototype was for dcn32_update_bw_bounding_box_fpu() instead


vim +247 drivers/gpu/drm/amd/amdgpu/../display/dc/dml/dcn32/dcn32_fpu.c

   245	
   246	/**
 > 247	 * Finds dummy_latency_index when MCLK switching using firmware based
   248	 * vblank stretch is enabled. This function will iterate through the
   249	 * table of dummy pstate latencies until the lowest value that allows
   250	 * dm_allow_self_refresh_and_mclk_switch to happen is found
   251	 */
   252	int dcn32_find_dummy_latency_index_for_fw_based_mclk_switch(struct dc *dc,
   253								    struct dc_state *context,
   254								    display_e2e_pipe_params_st *pipes,
   255								    int pipe_cnt,
   256								    int vlevel)
   257	{
   258		const int max_latency_table_entries = 4;
   259		const struct vba_vars_st *vba = &context->bw_ctx.dml.vba;
   260		int dummy_latency_index = 0;
   261	
   262		dc_assert_fp_enabled();
   263	
   264		while (dummy_latency_index < max_latency_table_entries) {
   265			context->bw_ctx.dml.soc.dram_clock_change_latency_us =
   266					dc->clk_mgr->bw_params->dummy_pstate_table[dummy_latency_index].dummy_pstate_latency_us;
   267			dcn32_internal_validate_bw(dc, context, pipes, &pipe_cnt, &vlevel, false);
   268	
   269			if (vlevel < context->bw_ctx.dml.vba.soc.num_states &&
   270					vba->DRAMClockChangeSupport[vlevel][vba->maxMpcComb] != dm_dram_clock_change_unsupported)
   271				break;
   272	
   273			dummy_latency_index++;
   274		}
   275	
   276		if (dummy_latency_index == max_latency_table_entries) {
   277			ASSERT(dummy_latency_index != max_latency_table_entries);
   278			/* If the execution gets here, it means dummy p_states are
   279			 * not possible. This should never happen and would mean
   280			 * something is severely wrong.
   281			 * Here we reset dummy_latency_index to 3, because it is
   282			 * better to have underflows than system crashes.
   283			 */
   284			dummy_latency_index = max_latency_table_entries - 1;
   285		}
   286	
   287		return dummy_latency_index;
   288	}
   289	

-- 
0-DAY CI Kernel Test Service
https://01.org/lkp

View attachment "config" of type "text/plain" (289394 bytes)