[android-common:android12-5.10 0/1] kernel/trace/ring_buffer.c:813: warning: Function parameter or member 'cpu' not described in 'ring_buffer_wake_waiters'

[kernel test robot <lkp@intel.com>]

tree:   https://android.googlesource.com/kernel/common android12-5.10
head:   a00af2707c1d0a67daa8f91db74300f65d84db3b
commit: 588f02f8b9d96c4a89db955394ec54e77b1d482f [0/1] ring-buffer: Add ring_buffer_wake_waiters()
config: i386-randconfig-012-20260702 (https://download.01.org/0day-ci/archive/20260704/202607041625.AsllUH9a-lkp@intel.com/config)
compiler: gcc-13 (Debian 13.3.0-16) 13.3.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20260704/202607041625.AsllUH9a-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 <lkp@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202607041625.AsllUH9a-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> kernel/trace/ring_buffer.c:813: warning: Function parameter or member 'cpu' not described in 'ring_buffer_wake_waiters'
   kernel/trace/ring_buffer.c:1424: warning: Function parameter or member 'cpu_buffer' not described in 'rb_check_list'
   kernel/trace/ring_buffer.c:1424: warning: Function parameter or member 'list' not described in 'rb_check_list'
   kernel/trace/ring_buffer.c:5005: warning: Excess function parameter 'cpu' description in 'ring_buffer_reset_online_cpus'


vim +813 kernel/trace/ring_buffer.c

   804	
   805	/**
   806	 * ring_buffer_wake_waiters - wake up any waiters on this ring buffer
   807	 * @buffer: The ring buffer to wake waiters on
   808	 *
   809	 * In the case of a file that represents a ring buffer is closing,
   810	 * it is prudent to wake up any waiters that are on this.
   811	 */
   812	void ring_buffer_wake_waiters(struct trace_buffer *buffer, int cpu)
 > 813	{
   814		struct ring_buffer_per_cpu *cpu_buffer;
   815		struct rb_irq_work *rbwork;
   816	
   817		if (cpu == RING_BUFFER_ALL_CPUS) {
   818	
   819			/* Wake up individual ones too. One level recursion */
   820			for_each_buffer_cpu(buffer, cpu)
   821				ring_buffer_wake_waiters(buffer, cpu);
   822	
   823			rbwork = &buffer->irq_work;
   824		} else {
   825			cpu_buffer = buffer->buffers[cpu];
   826			rbwork = &cpu_buffer->irq_work;
   827		}
   828	
   829		rbwork->wait_index++;
   830		/* make sure the waiters see the new index */
   831		smp_wmb();
   832	
   833		rb_wake_up_waiters(&rbwork->work);
   834	}
   835	

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