Re: [rcu:dev.2019.09.23a 61/77] htmldocs: kernel/rcu/tree.c:2706: warning: Function parameter or member 'krcp' not described in 'kfree_rcu_cpu_work'

2019-09-24 Thread Paul E. McKenney
On Tue, Sep 24, 2019 at 10:24:24AM +0800, kbuild test robot wrote:
> tree:   
> https://kernel.googlesource.com/pub/scm/linux/kernel/git/paulmck/linux-rcu.git
>  dev.2019.09.23a
> head:   97de53b94582c208ee239178b208b8e8b9472585
> commit: 3cc794ad18bfc6e46d58411b53f2784388d5bb85 [61/77] rcu: Add multiple 
> in-flight batches of kfree_rcu() work
> reproduce: make htmldocs
> 
> If you fix the issue, kindly add following tag
> Reported-by: kbuild test robot 
> 
> All warnings (new ones prefixed by >>):
> 
>Warning: The Sphinx 'sphinx_rtd_theme' HTML theme was not found. Make sure 
> you have the theme installed to produce pretty HTML output. Falling back to 
> the default theme.
>WARNING: dot(1) not found, for better output quality install graphviz from 
> http://www.graphviz.org
>WARNING: convert(1) not found, for SVG to PDF conversion install 
> ImageMagick (https://www.imagemagick.org)
>include/linux/spi/spi.h:190: warning: Function parameter or member 
> 'driver_override' not described in 'spi_device'
>include/linux/i2c.h:337: warning: Function parameter or member 'init_irq' 
> not described in 'i2c_client'
>include/linux/regulator/machine.h:196: warning: Function parameter or 
> member 'max_uV_step' not described in 'regulation_constraints'
>include/linux/regulator/driver.h:223: warning: Function parameter or 
> member 'resume' not described in 'regulator_ops'
>fs/direct-io.c:258: warning: Excess function parameter 'offset' 
> description in 'dio_complete'
>fs/libfs.c:496: warning: Excess function parameter 'available' description 
> in 'simple_write_end'
>fs/posix_acl.c:647: warning: Function parameter or member 'inode' not 
> described in 'posix_acl_update_mode'
>fs/posix_acl.c:647: warning: Function parameter or member 'mode_p' not 
> described in 'posix_acl_update_mode'
>fs/posix_acl.c:647: warning: Function parameter or member 'acl' not 
> described in 'posix_acl_update_mode'
>mm/util.c:1: warning: 'get_user_pages_fast' not found
>mm/slab.c:4215: warning: Function parameter or member 'objp' not described 
> in '__ksize'
>drivers/usb/typec/bus.c:1: warning: 'typec_altmode_register_driver' not 
> found
>drivers/usb/typec/bus.c:1: warning: 'typec_altmode_unregister_driver' not 
> found
>drivers/usb/typec/class.c:1: warning: 'typec_altmode_unregister_notifier' 
> not found
>drivers/usb/typec/class.c:1: warning: 'typec_altmode_register_notifier' 
> not found
>include/linux/w1.h:272: warning: Function parameter or member 
> 'of_match_table' not described in 'w1_family'
>include/linux/input/sparse-keymap.h:43: warning: Function parameter or 
> member 'sw' not described in 'key_entry'
>include/linux/mod_devicetable.h:822: warning: Function parameter or member 
> 'context' not described in 'wmi_device_id'
>drivers/gpu/drm/mcde/mcde_drv.c:1: warning: 'ST-Ericsson MCDE DRM Driver' 
> not found
>lib/genalloc.c:1: warning: 'gen_pool_add_virt' not found
>lib/genalloc.c:1: warning: 'gen_pool_alloc' not found
>lib/genalloc.c:1: warning: 'gen_pool_free' not found
>lib/genalloc.c:1: warning: 'gen_pool_alloc_algo' not found
>include/linux/clk.h:381: warning: Function parameter or member 'num_clks' 
> not described in 'devm_clk_bulk_get_optional'
> >> kernel/rcu/tree.c:2706: warning: Function parameter or member 'krcp' not 
> >> described in 'kfree_rcu_cpu_work'

Good catch, fix set up to squash into original.

Thanx, Paul

>include/linux/rculist.h:374: warning: Excess function parameter 'cond' 
> description in 'list_for_each_entry_rcu'
>include/linux/rculist.h:651: warning: Excess function parameter 'cond' 
> description in 'hlist_for_each_entry_rcu'
>drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c:142: warning: Function parameter or 
> member 'blockable' not described in 'amdgpu_mn_read_lock'
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:347: warning: cannot understand 
> function prototype: 'struct amdgpu_vm_pt_cursor '
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:348: warning: cannot understand 
> function prototype: 'struct amdgpu_vm_pt_cursor '
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:494: warning: Function parameter or 
> member 'start' not described in 'amdgpu_vm_pt_first_dfs'
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
> member 'adev' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
> member 'vm' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
> member 'start' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
> member 'cursor' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
>drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
> member 

[rcu:dev.2019.09.23a 61/77] htmldocs: kernel/rcu/tree.c:2706: warning: Function parameter or member 'krcp' not described in 'kfree_rcu_cpu_work'

2019-09-23 Thread kbuild test robot
tree:   
https://kernel.googlesource.com/pub/scm/linux/kernel/git/paulmck/linux-rcu.git 
dev.2019.09.23a
head:   97de53b94582c208ee239178b208b8e8b9472585
commit: 3cc794ad18bfc6e46d58411b53f2784388d5bb85 [61/77] rcu: Add multiple 
in-flight batches of kfree_rcu() work
reproduce: make htmldocs

If you fix the issue, kindly add following tag
Reported-by: kbuild test robot 

All warnings (new ones prefixed by >>):

   Warning: The Sphinx 'sphinx_rtd_theme' HTML theme was not found. Make sure 
you have the theme installed to produce pretty HTML output. Falling back to the 
default theme.
   WARNING: dot(1) not found, for better output quality install graphviz from 
http://www.graphviz.org
   WARNING: convert(1) not found, for SVG to PDF conversion install ImageMagick 
(https://www.imagemagick.org)
   include/linux/spi/spi.h:190: warning: Function parameter or member 
'driver_override' not described in 'spi_device'
   include/linux/i2c.h:337: warning: Function parameter or member 'init_irq' 
not described in 'i2c_client'
   include/linux/regulator/machine.h:196: warning: Function parameter or member 
'max_uV_step' not described in 'regulation_constraints'
   include/linux/regulator/driver.h:223: warning: Function parameter or member 
'resume' not described in 'regulator_ops'
   fs/direct-io.c:258: warning: Excess function parameter 'offset' description 
in 'dio_complete'
   fs/libfs.c:496: warning: Excess function parameter 'available' description 
in 'simple_write_end'
   fs/posix_acl.c:647: warning: Function parameter or member 'inode' not 
described in 'posix_acl_update_mode'
   fs/posix_acl.c:647: warning: Function parameter or member 'mode_p' not 
described in 'posix_acl_update_mode'
   fs/posix_acl.c:647: warning: Function parameter or member 'acl' not 
described in 'posix_acl_update_mode'
   mm/util.c:1: warning: 'get_user_pages_fast' not found
   mm/slab.c:4215: warning: Function parameter or member 'objp' not described 
in '__ksize'
   drivers/usb/typec/bus.c:1: warning: 'typec_altmode_register_driver' not found
   drivers/usb/typec/bus.c:1: warning: 'typec_altmode_unregister_driver' not 
found
   drivers/usb/typec/class.c:1: warning: 'typec_altmode_unregister_notifier' 
not found
   drivers/usb/typec/class.c:1: warning: 'typec_altmode_register_notifier' not 
found
   include/linux/w1.h:272: warning: Function parameter or member 
'of_match_table' not described in 'w1_family'
   include/linux/input/sparse-keymap.h:43: warning: Function parameter or 
member 'sw' not described in 'key_entry'
   include/linux/mod_devicetable.h:822: warning: Function parameter or member 
'context' not described in 'wmi_device_id'
   drivers/gpu/drm/mcde/mcde_drv.c:1: warning: 'ST-Ericsson MCDE DRM Driver' 
not found
   lib/genalloc.c:1: warning: 'gen_pool_add_virt' not found
   lib/genalloc.c:1: warning: 'gen_pool_alloc' not found
   lib/genalloc.c:1: warning: 'gen_pool_free' not found
   lib/genalloc.c:1: warning: 'gen_pool_alloc_algo' not found
   include/linux/clk.h:381: warning: Function parameter or member 'num_clks' 
not described in 'devm_clk_bulk_get_optional'
>> kernel/rcu/tree.c:2706: warning: Function parameter or member 'krcp' not 
>> described in 'kfree_rcu_cpu_work'
   include/linux/rculist.h:374: warning: Excess function parameter 'cond' 
description in 'list_for_each_entry_rcu'
   include/linux/rculist.h:651: warning: Excess function parameter 'cond' 
description in 'hlist_for_each_entry_rcu'
   drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c:142: warning: Function parameter or 
member 'blockable' not described in 'amdgpu_mn_read_lock'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:347: warning: cannot understand 
function prototype: 'struct amdgpu_vm_pt_cursor '
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:348: warning: cannot understand 
function prototype: 'struct amdgpu_vm_pt_cursor '
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:494: warning: Function parameter or 
member 'start' not described in 'amdgpu_vm_pt_first_dfs'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
member 'adev' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
member 'vm' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
member 'start' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
member 'cursor' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or 
member 'entry' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:823: warning: Function parameter or 
member 'level' not described in 'amdgpu_vm_bo_param'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or 
member 'params' not described in 'amdgpu_vm_update_flags'