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

From: kernel test robot
Date: Tue Oct 10 2023 - 21:52:53 EST


Hi Matti,

FYI, the error/warning still remains.

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 1c8b86a3799f7e5be903c3f49fcdaee29fd385b5
commit: dfa19b11385d4cf8f0242fd93e2073e25183c331 reboot: Add hardware protection power-off
date: 2 years, 4 months ago
config: csky-allnoconfig (https://download.01.org/0day-ci/archive/20231011/202310110952.0PSEypq4-lkp@xxxxxxxxx/config)
compiler: csky-linux-gcc (GCC) 12.3.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231011/202310110952.0PSEypq4-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/202310110952.0PSEypq4-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