kernel/reboot.c:559: warning: Function parameter or member 'poweroff_delay_ms' not described in 'hw_failure_emergency_poweroff'

From: kernel test robot
Date: Sun Nov 19 2023 - 03:30:50 EST


Hi Matti,

FYI, the error/warning still remains.

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 037266a5f7239ead1530266f7d7af153d2a867fa
commit: dfa19b11385d4cf8f0242fd93e2073e25183c331 reboot: Add hardware protection power-off
date: 2 years, 5 months ago
config: i386-allnoconfig (https://download.01.org/0day-ci/archive/20231119/202311191617.LlfQ8ae6-lkp@xxxxxxxxx/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/20231119/202311191617.LlfQ8ae6-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/202311191617.LlfQ8ae6-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

kernel/reboot.c:215: warning: Function parameter or member 'cmd' not described in 'do_kernel_restart'
>> kernel/reboot.c:559: warning: Function parameter or member 'poweroff_delay_ms' not described in 'hw_failure_emergency_poweroff'


vim +559 kernel/reboot.c

548
549 static DECLARE_DELAYED_WORK(hw_failure_emergency_poweroff_work,
550 hw_failure_emergency_poweroff_func);
551
552 /**
553 * hw_failure_emergency_poweroff - Trigger an emergency system poweroff
554 *
555 * This may be called from any critical situation to trigger a system shutdown
556 * after a given period of time. If time is negative this is not scheduled.
557 */
558 static void hw_failure_emergency_poweroff(int poweroff_delay_ms)
> 559 {
560 if (poweroff_delay_ms <= 0)
561 return;
562 schedule_delayed_work(&hw_failure_emergency_poweroff_work,
563 msecs_to_jiffies(poweroff_delay_ms));
564 }
565

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