linux-kernel - drivers/gpu/drm/amd/amdgpu/../display/dc/dcn31/dcn31_optc.c:95: 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: Windows password security audit tool. GUI, reports in PDF.

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

Date:   Sat, 26 Mar 2022 19:45:19 +0800
From:   kernel test robot <lkp@...el.com>
To:     Alex Deucher <alexander.deucher@....com>
Cc:     kbuild-all@...ts.01.org, linux-kernel@...r.kernel.org,
        Nicholas Kazlauskas <nicholas.kazlauskas@....com>,
        linux-doc@...r.kernel.org
Subject: drivers/gpu/drm/amd/amdgpu/../display/dc/dcn31/dcn31_optc.c:95:
 warning: This comment starts with '/**', but isn't a kernel-doc comment.
 Refer Documentation/doc-guide/kernel-doc.rst

Hi Alex,

First bad commit (maybe != root cause):

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   52d543b5497cf31d6baeb0bcfe5a5474c3238578
commit: 8fe44c080a53ac0ccbe88053a2e40f9acca33091 drm/amdgpu/display: fold DRM_AMD_DC_DCN3_1 into DRM_AMD_DC_DCN
date:   9 months ago
config: powerpc64-randconfig-r015-20220325 (https://download.01.org/0day-ci/archive/20220326/202203261919.vs4G6G1g-lkp@intel.com/config)
compiler: powerpc64-linux-gcc (GCC) 11.2.0
reproduce (this is a W=1 build):
        wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
        chmod +x ~/bin/make.cross
        # https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=8fe44c080a53ac0ccbe88053a2e40f9acca33091
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout 8fe44c080a53ac0ccbe88053a2e40f9acca33091
        # save the config file to linux build tree
        mkdir build_dir
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-11.2.0 make.cross O=build_dir ARCH=powerpc SHELL=/bin/bash drivers/gpu/drm/

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

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/amd/amdgpu/../display/dc/dcn31/dcn31_optc.c:95: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Enable CRTC


vim +95 drivers/gpu/drm/amd/amdgpu/../display/dc/dcn31/dcn31_optc.c

110d3968fe9508 Nicholas Kazlauskas 2021-05-19   93  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19   94  /**
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  @95   * Enable CRTC
110d3968fe9508 Nicholas Kazlauskas 2021-05-19   96   * Enable CRTC - call ASIC Control Object to enable Timing generator.
110d3968fe9508 Nicholas Kazlauskas 2021-05-19   97   */
110d3968fe9508 Nicholas Kazlauskas 2021-05-19   98  static bool optc31_enable_crtc(struct timing_generator *optc)
110d3968fe9508 Nicholas Kazlauskas 2021-05-19   99  {
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  100  	struct optc *optc1 = DCN10TG_FROM_TG(optc);
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  101  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  102  	/* opp instance for OTG, 1 to 1 mapping and odm will adjust */
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  103  	REG_UPDATE(OPTC_DATA_SOURCE_SELECT,
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  104  			OPTC_SEG0_SRC_SEL, optc->inst);
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  105  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  106  	/* VTG enable first is for HW workaround */
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  107  	REG_UPDATE(CONTROL,
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  108  			VTG0_ENABLE, 1);
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  109  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  110  	REG_SEQ_START();
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  111  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  112  	/* Enable CRTC */
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  113  	REG_UPDATE_2(OTG_CONTROL,
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  114  			OTG_DISABLE_POINT_CNTL, 2,
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  115  			OTG_MASTER_EN, 1);
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  116  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  117  	REG_SEQ_SUBMIT();
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  118  	REG_SEQ_WAIT_DONE();
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  119  
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  120  	return true;
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  121  }
110d3968fe9508 Nicholas Kazlauskas 2021-05-19  122  

:::::: The code at line 95 was first introduced by commit
:::::: 110d3968fe9508142cb76b530d141209efa169a8 drm/amd/display: Add DCN3.1 OPTC

:::::: TO: Nicholas Kazlauskas <nicholas.kazlauskas@....com>
:::::: CC: Alex Deucher <alexander.deucher@....com>

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