kernel/reboot.c:214: warning: Function parameter or struct member 'cmd' not described in 'do_kernel_restart'

kernel/reboot.c:214: warning: Function parameter or struct member 'cmd' not described in 'do_kernel_restart'

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   56e6a3499e14716b9a28a307bb6d18c10e95301e
commit: e16260c21f87b16a33ae8ecac9e8c79f3a8b89bd parisc: fix compilation when KEXEC=n and KEXEC_FILE=y
date:   5 years ago
config: parisc-randconfig-c44-20220907 (https://download.01.org/0day-ci/archive/20250103/202501030323.cz0NqDd5-lkp@intel.com/config)
compiler: hppa-linux-gcc (GCC) 12.4.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250103/202501030323.cz0NqDd5-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/202501030323.cz0NqDd5-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> kernel/reboot.c:214: warning: Function parameter or struct member 'cmd' not described in 'do_kernel_restart'
--
>> kernel/kexec_elf.c:64: warning: Function parameter or struct member 'ehdr' not described in 'elf_is_ehdr_sane'
>> kernel/kexec_elf.c:186: warning: Function parameter or struct member 'phdr' not described in 'elf_is_phdr_sane'
>> kernel/kexec_elf.c:253: warning: Function parameter or struct member 'buf' not described in 'elf_read_phdrs'
>> kernel/kexec_elf.c:253: warning: Function parameter or struct member 'len' not described in 'elf_read_phdrs'
>> kernel/kexec_elf.c:253: warning: Function parameter or struct member 'elf_info' not described in 'elf_read_phdrs'
>> kernel/kexec_elf.c:320: warning: Function parameter or struct member 'elf_info' not described in 'kexec_free_elf_info'
>> kernel/kexec_elf.c:329: warning: Function parameter or struct member 'buf' not described in 'kexec_build_elf_info'
>> kernel/kexec_elf.c:329: warning: Function parameter or struct member 'len' not described in 'kexec_build_elf_info'
>> kernel/kexec_elf.c:329: warning: Function parameter or struct member 'ehdr' not described in 'kexec_build_elf_info'
>> kernel/kexec_elf.c:329: warning: Function parameter or struct member 'elf_info' not described in 'kexec_build_elf_info'
>> kernel/kexec_elf.c:392: warning: Function parameter or struct member 'image' not described in 'kexec_elf_load'
>> kernel/kexec_elf.c:392: warning: Function parameter or struct member 'ehdr' not described in 'kexec_elf_load'
>> kernel/kexec_elf.c:392: warning: Function parameter or struct member 'elf_info' not described in 'kexec_elf_load'
>> kernel/kexec_elf.c:392: warning: Function parameter or struct member 'kbuf' not described in 'kexec_elf_load'


vim +214 kernel/reboot.c

b63adb979583ef Guenter Roeck 2014-09-26  201  
b63adb979583ef Guenter Roeck 2014-09-26  202  /**
b63adb979583ef Guenter Roeck 2014-09-26  203   *	do_kernel_restart - Execute kernel restart handler call chain
b63adb979583ef Guenter Roeck 2014-09-26  204   *
b63adb979583ef Guenter Roeck 2014-09-26  205   *	Calls functions registered with register_restart_handler.
b63adb979583ef Guenter Roeck 2014-09-26  206   *
b63adb979583ef Guenter Roeck 2014-09-26  207   *	Expected to be called from machine_restart as last step of the restart
b63adb979583ef Guenter Roeck 2014-09-26  208   *	sequence.
b63adb979583ef Guenter Roeck 2014-09-26  209   *
b63adb979583ef Guenter Roeck 2014-09-26  210   *	Restarts the system immediately if a restart handler function has been
b63adb979583ef Guenter Roeck 2014-09-26  211   *	registered. Otherwise does nothing.
b63adb979583ef Guenter Roeck 2014-09-26  212   */
b63adb979583ef Guenter Roeck 2014-09-26  213  void do_kernel_restart(char *cmd)
b63adb979583ef Guenter Roeck 2014-09-26 @214  {
b63adb979583ef Guenter Roeck 2014-09-26  215  	atomic_notifier_call_chain(&restart_handler_list, reboot_mode, cmd);
b63adb979583ef Guenter Roeck 2014-09-26  216  }
b63adb979583ef Guenter Roeck 2014-09-26  217  

:::::: The code at line 214 was first introduced by commit
:::::: b63adb979583ef185718d774d8162387db5589c0 kernel: add support for kernel restart handler call chain

:::::: TO: Guenter Roeck <linux@roeck-us.net>
:::::: CC: Guenter Roeck <linux@roeck-us.net>

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