[rcu:rcu/dev 57/76] htmldocs: kernel/rcu/update.c:597: warning: No description found for parameter 'rhp'

From: kbuild test robot
Date: Wed May 03 2017 - 21:10:17 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/paulmck/linux-rcu.git rcu/dev
head: 901e798bdc9249ffd86a4d4cb002a6772660e41d
commit: e3f53ab9491c1c4b321bde579c906a630fab4da8 [57/76] rcu: Move docbook comments out of rcupdate.h
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

include/linux/init.h:1: warning: no structured comments found
kernel/sched/core.c:2085: warning: No description found for parameter 'rf'
kernel/sched/core.c:2085: warning: Excess function parameter 'cookie' description in 'try_to_wake_up_local'
include/linux/kthread.h:26: warning: Excess function parameter '...' description in 'kthread_create'
kernel/sys.c:1: warning: no structured comments found
>> kernel/rcu/update.c:597: warning: No description found for parameter 'rhp'
>> kernel/rcu/update.c:597: warning: Excess function parameter 'head' description in 'call_rcu_tasks'
include/linux/device.h:969: warning: No description found for parameter 'dma_ops'
drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
include/linux/iio/iio.h:597: warning: No description found for parameter 'trig_readonly'
include/linux/iio/trigger.h:151: warning: No description found for parameter 'indio_dev'
include/linux/iio/trigger.h:151: warning: No description found for parameter 'trig'
include/linux/device.h:970: warning: No description found for parameter 'dma_ops'
drivers/regulator/core.c:1467: warning: Excess function parameter 'ret' description in 'regulator_dev_lookup'
include/drm/drm_drv.h:438: warning: No description found for parameter 'open'
include/drm/drm_drv.h:438: warning: No description found for parameter 'preclose'
include/drm/drm_drv.h:438: warning: No description found for parameter 'postclose'
include/drm/drm_drv.h:438: warning: No description found for parameter 'lastclose'
include/drm/drm_drv.h:438: warning: No description found for parameter 'set_busid'
include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_handler'
include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_preinstall'
include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_postinstall'
include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_uninstall'
include/drm/drm_drv.h:438: warning: No description found for parameter 'debugfs_init'
include/drm/drm_drv.h:438: warning: No description found for parameter 'debugfs_cleanup'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_open_object'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_close_object'
include/drm/drm_drv.h:438: warning: No description found for parameter 'prime_handle_to_fd'
include/drm/drm_drv.h:438: warning: No description found for parameter 'prime_fd_to_handle'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_export'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_import'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_pin'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_unpin'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_res_obj'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_get_sg_table'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_import_sg_table'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_vmap'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_vunmap'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_mmap'
include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_vm_ops'
include/drm/drm_drv.h:438: warning: No description found for parameter 'major'
include/drm/drm_drv.h:438: warning: No description found for parameter 'minor'
include/drm/drm_drv.h:438: warning: No description found for parameter 'patchlevel'
include/drm/drm_drv.h:438: warning: No description found for parameter 'name'
include/drm/drm_drv.h:438: warning: No description found for parameter 'desc'
include/drm/drm_drv.h:438: warning: No description found for parameter 'date'
include/drm/drm_drv.h:438: warning: No description found for parameter 'driver_features'
include/drm/drm_drv.h:438: warning: No description found for parameter 'ioctls'
include/drm/drm_drv.h:438: warning: No description found for parameter 'num_ioctls'
include/drm/drm_drv.h:438: warning: No description found for parameter 'fops'
include/drm/drm_color_mgmt.h:1: warning: no structured comments found
drivers/gpu/drm/drm_fb_cma_helper.c:557: warning: Excess function parameter 'num_crtc' description in 'drm_fbdev_cma_init'
drivers/gpu/drm/drm_fb_cma_helper.c:558: warning: Excess function parameter 'num_crtc' description in 'drm_fbdev_cma_init'
drivers/gpu/drm/i915/intel_lpe_audio.c:342: warning: No description found for parameter 'pipe'
drivers/gpu/drm/i915/intel_lpe_audio.c:342: warning: No description found for parameter 'dp_output'
drivers/gpu/drm/i915/intel_lpe_audio.c:342: warning: No description found for parameter 'link_rate'
drivers/gpu/drm/i915/intel_lpe_audio.c:343: warning: No description found for parameter 'pipe'
drivers/gpu/drm/i915/intel_lpe_audio.c:343: warning: No description found for parameter 'dp_output'
drivers/gpu/drm/i915/intel_lpe_audio.c:343: warning: No description found for parameter 'link_rate'
drivers/media/dvb-core/dvb_frontend.h:677: warning: No description found for parameter 'refcount'
Documentation/core-api/assoc_array.rst:13: WARNING: Enumerated list ends without a blank line; unexpected unindent.
Documentation/doc-guide/sphinx.rst:110: ERROR: Unknown target name: "sphinx c domain".
kernel/sched/fair.c:7616: WARNING: Inline emphasis start-string without end-string.
kernel/time/timer.c:1200: ERROR: Unexpected indentation.
kernel/time/timer.c:1202: ERROR: Unexpected indentation.
kernel/time/timer.c:1203: WARNING: Block quote ends without a blank line; unexpected unindent.
include/linux/wait.h:122: WARNING: Block quote ends without a blank line; unexpected unindent.
include/linux/wait.h:125: ERROR: Unexpected indentation.
include/linux/wait.h:127: WARNING: Block quote ends without a blank line; unexpected unindent.
kernel/time/hrtimer.c:990: WARNING: Block quote ends without a blank line; unexpected unindent.
kernel/signal.c:322: WARNING: Inline literal start-string without end-string.
kernel/rcu/tree.c:3225: ERROR: Unexpected indentation.
kernel/rcu/tree.c:3226: WARNING: Bullet list ends without a blank line; unexpected unindent.
kernel/rcu/tree.c:3252: ERROR: Unexpected indentation.
kernel/rcu/tree.c:3253: WARNING: Bullet list ends without a blank line; unexpected unindent.
include/linux/iio/iio.h:219: ERROR: Unexpected indentation.
include/linux/iio/iio.h:220: WARNING: Block quote ends without a blank line; unexpected unindent.
include/linux/iio/iio.h:226: WARNING: Definition list ends without a blank line; unexpected unindent.
drivers/iio/industrialio-core.c:638: ERROR: Unknown target name: "iio_val".
drivers/iio/industrialio-core.c:645: ERROR: Unknown target name: "iio_val".
drivers/message/fusion/mptbase.c:5051: WARNING: Definition list ends without a blank line; unexpected unindent.
drivers/tty/serial/serial_core.c:1898: WARNING: Definition list ends without a blank line; unexpected unindent.
include/linux/regulator/driver.h:271: ERROR: Unknown target name: "regulator_regmap_x_voltage".
include/linux/spi/spi.h:369: ERROR: Unexpected indentation.
drivers/usb/core/message.c:478: ERROR: Unexpected indentation.
drivers/usb/core/message.c:479: WARNING: Block quote ends without a blank line; unexpected unindent.
Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_type".
Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_dir".
Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_recip".
Documentation/driver-api/usb.rst:689: ERROR: Unknown target name: "usbdevfs_urb_type".
sound/soc/soc-core.c:2670: ERROR: Unknown target name: "snd_soc_daifmt".
sound/core/jack.c:312: ERROR: Unknown target name: "snd_jack_btn".
WARNING: dvipng command 'dvipng' cannot be run (needed for math display), check the imgmath_dvipng setting

vim +/rhp +597 kernel/rcu/update.c

e3f53ab9 Paul E. McKenney 2017-05-03 581 *
e3f53ab9 Paul E. McKenney 2017-05-03 582 * The callback function will be invoked some time after a full grace
e3f53ab9 Paul E. McKenney 2017-05-03 583 * period elapses, in other words after all currently executing RCU
e3f53ab9 Paul E. McKenney 2017-05-03 584 * read-side critical sections have completed. call_rcu_tasks() assumes
e3f53ab9 Paul E. McKenney 2017-05-03 585 * that the read-side critical sections end at a voluntary context
e3f53ab9 Paul E. McKenney 2017-05-03 586 * switch (not a preemption!), entry into idle, or transition to usermode
e3f53ab9 Paul E. McKenney 2017-05-03 587 * execution. As such, there are no read-side primitives analogous to
e3f53ab9 Paul E. McKenney 2017-05-03 588 * rcu_read_lock() and rcu_read_unlock() because this primitive is intended
e3f53ab9 Paul E. McKenney 2017-05-03 589 * to determine that all tasks have passed through a safe state, not so
e3f53ab9 Paul E. McKenney 2017-05-03 590 * much for data-strcuture synchronization.
e3f53ab9 Paul E. McKenney 2017-05-03 591 *
e3f53ab9 Paul E. McKenney 2017-05-03 592 * See the description of call_rcu() for more detailed information on
e3f53ab9 Paul E. McKenney 2017-05-03 593 * memory ordering guarantees.
84a8f446 Paul E. McKenney 2014-08-04 594 */
b6a4ae76 Boqun Feng 2015-07-29 595 void call_rcu_tasks(struct rcu_head *rhp, rcu_callback_t func)
8315f422 Paul E. McKenney 2014-06-27 596 {
8315f422 Paul E. McKenney 2014-06-27 @597 unsigned long flags;
c7b24d2b Paul E. McKenney 2014-07-28 598 bool needwake;
4929c913 Paul E. McKenney 2016-05-02 599 bool havetask = READ_ONCE(rcu_tasks_kthread_ptr);
8315f422 Paul E. McKenney 2014-06-27 600
8315f422 Paul E. McKenney 2014-06-27 601 rhp->next = NULL;
8315f422 Paul E. McKenney 2014-06-27 602 rhp->func = func;
8315f422 Paul E. McKenney 2014-06-27 603 raw_spin_lock_irqsave(&rcu_tasks_cbs_lock, flags);
c7b24d2b Paul E. McKenney 2014-07-28 604 needwake = !rcu_tasks_cbs_head;
8315f422 Paul E. McKenney 2014-06-27 605 *rcu_tasks_cbs_tail = rhp;

:::::: The code at line 597 was first introduced by commit
:::::: 8315f42295d2667a7f942f154b73a86fd7cb2227 rcu: Add call_rcu_tasks()

:::::: TO: Paul E. McKenney <paulmck@xxxxxxxxxxxxxxxxxx>
:::::: CC: Paul E. McKenney <paulmck@xxxxxxxxxxxxxxxxxx>

---
0-DAY kernel test infrastructure Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all Intel Corporation

Attachment: .config.gz
Description: application/gzip