Messages in this thread | | | Date | Thu, 4 May 2017 09:07:52 +0800 | From | kbuild test robot <> | Subject | [rcu:rcu/dev 57/76] htmldocs: kernel/rcu/update.c:597: warning: No description found for parameter 'rhp' |
| |
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@linux.vnet.ibm.com> :::::: CC: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
--- 0-DAY kernel test infrastructure Open Source Technology Center https://lists.01.org/pipermail/kbuild-all Intel Corporation [unhandled content-type:application/gzip] | |