Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37;
Date:   Thu, 16 Nov 2023 09:09:45 +0800
From:   kernel test robot <yujie.liu@intel.com>
To:     Alexander Shishkin <alexander.shishkin@linux.intel.com>
CC:     <oe-kbuild-all@lists.linux.dev>, <linux-kernel@vger.kernel.org>,
        "Laurent Fert" <laurent.fert@intel.com>
Subject: drivers/hwtracing/intel_th/msu.c:60: warning: Function parameter or
 member 'msc' not described in 'msc_window'
Message-ID: <202311160709.39OzBNLo-lkp@intel.com>
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?J1b8WSx5G4Wbgg8rrjymiRXHZdWTYjrZr8Jzehq4EMCsd+F99tJF6h1JQMij?=
 =?us-ascii?Q?geyHWsPi6wlt0LEU7eHFq2Z1ayi85X1nUWtO87hNleObreqYHUD59ruZhoUt?=
 =?us-ascii?Q?gjbcPzoGQnxuEDhOj2i49uSlaEUJMf4i5IXZNpu2YEKHCwLYrSTkJTo+MQ1h?=
 =?us-ascii?Q?fz8ajRrF4OYxqlSqc4eMjMkGl9Z/8q+koHPDvB+3B2tiIsqIDepOBEIEqVmT?=
 =?us-ascii?Q?fEKV+/IGp0wfOoYyByyx8A1sAX3CbEO8/o0oNakAliO2cZa26fKGwvX3Fisu?=
 =?us-ascii?Q?VTIqmgn6GGXJqhO4RaqKbAmwuhXu1o1r0J3i4ZaucYKOWvVP7fep/+YBDfOX?=
 =?us-ascii?Q?uv1KtjQE6FdgqJvcDI889uDBcEcFxaoTLwwqTxOzk9Z2Tysm3f2pI1Y1mtcm?=
 =?us-ascii?Q?YEj0M1f9klB3z1F+0gNZGEuF6EmsIF26Ed2Wb2oBi6CoFL3Pa5iatv0W2nIe?=
 =?us-ascii?Q?5+SbBdQbh57Cyo8DsdGtUAokrYFdqhISStA6cXcPZy7ezJIO85hROjncQ+gg?=
 =?us-ascii?Q?k/h8iyW9QPx3D8TP/2HAFwVe7okyg/yDocqLoQSw97NZmGIO6te4Ve8OPiVz?=
 =?us-ascii?Q?ufGtoIjLlmUsBW1tjUN0MK6PGzrgHmwyHthiMby86bA9hOlG09c6zWdkyYor?=
 =?us-ascii?Q?yE3hVfxlPLAgfpr+lhwkNxt8EZLSrwE89Mp7chFKNA0TYPe8CD/UJJ5K9hz3?=
 =?us-ascii?Q?1yoMlmsEGDOHWtSE9G8zlrVcWsqeYvapiU7kZo3J86sBjiUCUuS2Xo0ygsbl?=
 =?us-ascii?Q?WZ6aWTmmRqkc4dH/ePgSjPbaByvvzwUJ9GQLgS+HSjSnCi7/z9hAAGHxT9g3?=
 =?us-ascii?Q?h0BU+jIiH0V3PMsmTNXtyP/f5JFC8Amxfc+V0nxxUQ1pM3iuRheCME2YAyOP?=
 =?us-ascii?Q?4L6tWCM4zlR0QZwu2ym5ZXDFuUJaadPlfHbyvZK2V6oekaXAY1U6Kc/zLXtY?=
 =?us-ascii?Q?+80F57fsn/rbtgZp68FAmVENkXd7sfdV6Zz7FYmRLlZyzP9Tf8R29sulPMrq?=
 =?us-ascii?Q?2gIPUoJszswzGq18xttetJQjMzP6/kO96gtaL7PsUw7ooizpFl0jTRaXCnU7?=
 =?us-ascii?Q?y305Vztwcz2iIbFM0JnCe5FXEpHIpspV6sQkCkC9c//6vc+TnbRcnwm/WQMV?=
 =?us-ascii?Q?tWc1ewaUmZddTkYevUsCb6rlM3w3CIu8goPfVEVCw7DFSjWEY+h/C3Tw7F9S?=
 =?us-ascii?Q?Y+9vdO1IrwBsbS5yDEucEnzIUBKbvHRXqHzRr3U3rgicGqkdLvn36Z6pZ2Zn?=
 =?us-ascii?Q?rk50GY29EVVVi1bQs7S6WF6KOsWbUDK2bK0uiyV948cKwk789f3i8VHIKWD1?=
 =?us-ascii?Q?fStRh8zPXNXWyfIefaomY9fNLHjWtt4lb12pfGnHOg2FMl28pb7gJ5U7YOu+?=
 =?us-ascii?Q?UwsHV975O6F7pa8DqzT5wnM1/2QRGiEW2nbIhQ+SodDMvDrhKoZ4ExdtI8j7?=
 =?us-ascii?Q?j/FyZoLjn8FJS2H4HNswwe0KNqckF+8Y/GHbXU4oLoOCpNXH3N3eA1n2axJh?=
 =?us-ascii?Q?BVwa08i7FLlK+EVrY5SWXbV9t6MSPY11a38tx8z2zn6z/ODtYDdjgOC1nYec?=
 =?us-ascii?Q?9U5fkgh5ddL3wfnVw4Nmcppqy/40gc+h2zfiHOXi?=
X-MS-Exchange-CrossTenant-Network-Message-Id: 483a8e02-958e-4975-9e2e-08dbe6415f0b
X-MS-Exchange-CrossTenant-AuthSource: CY5PR11MB6392.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Nov 2023 01:14:24.8292
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: MiPNQnwVjb8cmCcjq5I8Cjk6wB0dLOsBGysGtOtZVtr7ka7Qhr5XM3j9e9fHvxDXW26LPpOuZRsZ+Q9vP3mvqQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR11MB7776
X-OriginatorOrg: intel.com
X-Spam-Status: No, score=-2.2 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,
        DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,
        RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_NONE,T_SCC_BODY_TEXT_LINE,
        URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 15 Nov 2023 17:14:37 -0800 (PST)

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   c42d9eeef8e5ba9292eda36fd8e3c11f35ee065c
commit: ba82664c134ef7ab97808f09a3c5e894b0a4900d intel_th: Add Memory Storage Unit driver
config: x86_64-randconfig-x011-20230813 (https://download.01.org/0day-ci/archive/20231116/202311160709.39OzBNLo-lkp@intel.com/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231116/202311160709.39OzBNLo-lkp@intel.com/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 <yujie.liu@intel.com>
| Closes: https://lore.kernel.org/r/202311160709.39OzBNLo-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/hwtracing/intel_th/msu.c:60: warning: Function parameter or member 'msc' not described in 'msc_window'
>> drivers/hwtracing/intel_th/msu.c:101: warning: bad line: 
   drivers/hwtracing/intel_th/msu.c:134: warning: Function parameter or member 'iter_mutex' not described in 'msc'
>> drivers/hwtracing/intel_th/msu.c:134: warning: Function parameter or member 'iter_list' not described in 'msc'
>> drivers/hwtracing/intel_th/msu.c:894: warning: Function parameter or member 'nr_pages' not described in 'msc_buffer_alloc'
>> drivers/hwtracing/intel_th/msu.c:894: warning: Function parameter or member 'nr_wins' not described in 'msc_buffer_alloc'
>> drivers/hwtracing/intel_th/msu.c:894: warning: Excess function parameter 'size' description in 'msc_buffer_alloc'


vim +60 drivers/hwtracing/intel_th/msu.c

ba82664c134ef7a Alexander Shishkin 2015-09-22   46  
ba82664c134ef7a Alexander Shishkin 2015-09-22   47  /**
ba82664c134ef7a Alexander Shishkin 2015-09-22   48   * struct msc_window - multiblock mode window descriptor
ba82664c134ef7a Alexander Shishkin 2015-09-22   49   * @entry:	window list linkage (msc::win_list)
ba82664c134ef7a Alexander Shishkin 2015-09-22   50   * @pgoff:	page offset into the buffer that this window starts at
ba82664c134ef7a Alexander Shishkin 2015-09-22   51   * @nr_blocks:	number of blocks (pages) in this window
ba82664c134ef7a Alexander Shishkin 2015-09-22   52   * @block:	array of block descriptors
ba82664c134ef7a Alexander Shishkin 2015-09-22   53   */
ba82664c134ef7a Alexander Shishkin 2015-09-22   54  struct msc_window {
ba82664c134ef7a Alexander Shishkin 2015-09-22   55  	struct list_head	entry;
ba82664c134ef7a Alexander Shishkin 2015-09-22   56  	unsigned long		pgoff;
ba82664c134ef7a Alexander Shishkin 2015-09-22   57  	unsigned int		nr_blocks;
ba82664c134ef7a Alexander Shishkin 2015-09-22   58  	struct msc		*msc;
ba82664c134ef7a Alexander Shishkin 2015-09-22   59  	struct msc_block	block[0];
ba82664c134ef7a Alexander Shishkin 2015-09-22  @60  };
ba82664c134ef7a Alexander Shishkin 2015-09-22   61  
ba82664c134ef7a Alexander Shishkin 2015-09-22   62  /**
ba82664c134ef7a Alexander Shishkin 2015-09-22   63   * struct msc_iter - iterator for msc buffer
ba82664c134ef7a Alexander Shishkin 2015-09-22   64   * @entry:		msc::iter_list linkage
ba82664c134ef7a Alexander Shishkin 2015-09-22   65   * @msc:		pointer to the MSC device
ba82664c134ef7a Alexander Shishkin 2015-09-22   66   * @start_win:		oldest window
ba82664c134ef7a Alexander Shishkin 2015-09-22   67   * @win:		current window
ba82664c134ef7a Alexander Shishkin 2015-09-22   68   * @offset:		current logical offset into the buffer
ba82664c134ef7a Alexander Shishkin 2015-09-22   69   * @start_block:	oldest block in the window
ba82664c134ef7a Alexander Shishkin 2015-09-22   70   * @block:		block number in the window
ba82664c134ef7a Alexander Shishkin 2015-09-22   71   * @block_off:		offset into current block
ba82664c134ef7a Alexander Shishkin 2015-09-22   72   * @wrap_count:		block wrapping handling
ba82664c134ef7a Alexander Shishkin 2015-09-22   73   * @eof:		end of buffer reached
ba82664c134ef7a Alexander Shishkin 2015-09-22   74   */
ba82664c134ef7a Alexander Shishkin 2015-09-22   75  struct msc_iter {
ba82664c134ef7a Alexander Shishkin 2015-09-22   76  	struct list_head	entry;
ba82664c134ef7a Alexander Shishkin 2015-09-22   77  	struct msc		*msc;
ba82664c134ef7a Alexander Shishkin 2015-09-22   78  	struct msc_window	*start_win;
ba82664c134ef7a Alexander Shishkin 2015-09-22   79  	struct msc_window	*win;
ba82664c134ef7a Alexander Shishkin 2015-09-22   80  	unsigned long		offset;
ba82664c134ef7a Alexander Shishkin 2015-09-22   81  	int			start_block;
ba82664c134ef7a Alexander Shishkin 2015-09-22   82  	int			block;
ba82664c134ef7a Alexander Shishkin 2015-09-22   83  	unsigned int		block_off;
ba82664c134ef7a Alexander Shishkin 2015-09-22   84  	unsigned int		wrap_count;
ba82664c134ef7a Alexander Shishkin 2015-09-22   85  	unsigned int		eof;
ba82664c134ef7a Alexander Shishkin 2015-09-22   86  };
ba82664c134ef7a Alexander Shishkin 2015-09-22   87  
ba82664c134ef7a Alexander Shishkin 2015-09-22   88  /**
ba82664c134ef7a Alexander Shishkin 2015-09-22   89   * struct msc - MSC device representation
ba82664c134ef7a Alexander Shishkin 2015-09-22   90   * @reg_base:		register window base address
ba82664c134ef7a Alexander Shishkin 2015-09-22   91   * @thdev:		intel_th_device pointer
ba82664c134ef7a Alexander Shishkin 2015-09-22   92   * @win_list:		list of windows in multiblock mode
ba82664c134ef7a Alexander Shishkin 2015-09-22   93   * @nr_pages:		total number of pages allocated for this buffer
ba82664c134ef7a Alexander Shishkin 2015-09-22   94   * @single_sz:		amount of data in single mode
ba82664c134ef7a Alexander Shishkin 2015-09-22   95   * @single_wrap:	single mode wrap occurred
ba82664c134ef7a Alexander Shishkin 2015-09-22   96   * @base:		buffer's base pointer
ba82664c134ef7a Alexander Shishkin 2015-09-22   97   * @base_addr:		buffer's base address
ba82664c134ef7a Alexander Shishkin 2015-09-22   98   * @user_count:		number of users of the buffer
ba82664c134ef7a Alexander Shishkin 2015-09-22   99   * @mmap_count:		number of mappings
ba82664c134ef7a Alexander Shishkin 2015-09-22  100   * @buf_mutex:		mutex to serialize access to buffer-related bits
ba82664c134ef7a Alexander Shishkin 2015-09-22 @101  
ba82664c134ef7a Alexander Shishkin 2015-09-22  102   * @enabled:		MSC is enabled
ba82664c134ef7a Alexander Shishkin 2015-09-22  103   * @wrap:		wrapping is enabled
ba82664c134ef7a Alexander Shishkin 2015-09-22  104   * @mode:		MSC operating mode
ba82664c134ef7a Alexander Shishkin 2015-09-22  105   * @burst_len:		write burst length
ba82664c134ef7a Alexander Shishkin 2015-09-22  106   * @index:		number of this MSC in the MSU
ba82664c134ef7a Alexander Shishkin 2015-09-22  107   */
ba82664c134ef7a Alexander Shishkin 2015-09-22  108  struct msc {
ba82664c134ef7a Alexander Shishkin 2015-09-22  109  	void __iomem		*reg_base;
ba82664c134ef7a Alexander Shishkin 2015-09-22  110  	struct intel_th_device	*thdev;
ba82664c134ef7a Alexander Shishkin 2015-09-22  111  
ba82664c134ef7a Alexander Shishkin 2015-09-22  112  	struct list_head	win_list;
ba82664c134ef7a Alexander Shishkin 2015-09-22  113  	unsigned long		nr_pages;
ba82664c134ef7a Alexander Shishkin 2015-09-22  114  	unsigned long		single_sz;
ba82664c134ef7a Alexander Shishkin 2015-09-22  115  	unsigned int		single_wrap : 1;
ba82664c134ef7a Alexander Shishkin 2015-09-22  116  	void			*base;
ba82664c134ef7a Alexander Shishkin 2015-09-22  117  	dma_addr_t		base_addr;
ba82664c134ef7a Alexander Shishkin 2015-09-22  118  
ba82664c134ef7a Alexander Shishkin 2015-09-22  119  	/* <0: no buffer, 0: no users, >0: active users */
ba82664c134ef7a Alexander Shishkin 2015-09-22  120  	atomic_t		user_count;
ba82664c134ef7a Alexander Shishkin 2015-09-22  121  
ba82664c134ef7a Alexander Shishkin 2015-09-22  122  	atomic_t		mmap_count;
ba82664c134ef7a Alexander Shishkin 2015-09-22  123  	struct mutex		buf_mutex;
ba82664c134ef7a Alexander Shishkin 2015-09-22  124  
ba82664c134ef7a Alexander Shishkin 2015-09-22  125  	struct mutex		iter_mutex;
ba82664c134ef7a Alexander Shishkin 2015-09-22  126  	struct list_head	iter_list;
ba82664c134ef7a Alexander Shishkin 2015-09-22  127  
ba82664c134ef7a Alexander Shishkin 2015-09-22  128  	/* config */
ba82664c134ef7a Alexander Shishkin 2015-09-22  129  	unsigned int		enabled : 1,
ba82664c134ef7a Alexander Shishkin 2015-09-22  130  				wrap	: 1;
ba82664c134ef7a Alexander Shishkin 2015-09-22  131  	unsigned int		mode;
ba82664c134ef7a Alexander Shishkin 2015-09-22  132  	unsigned int		burst_len;
ba82664c134ef7a Alexander Shishkin 2015-09-22  133  	unsigned int		index;
ba82664c134ef7a Alexander Shishkin 2015-09-22 @134  };
ba82664c134ef7a Alexander Shishkin 2015-09-22  135  

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