[drm-intel:for-linux-next 2/4] htmldocs: drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'offset'

kbuild test robot fengguang.wu at intel.com
Wed Jan 11 17:51:04 UTC 2017


tree:   git://anongit.freedesktop.org/drm-intel for-linux-next
head:   c781c978e784c50dcd7cb312fe17f5281923f55b
commit: 625d988acc28f3fe1d44f3798426561c17387a59 [2/4] drm/i915: Extract reserving space in the GTT to a helper
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   make[3]: warning: jobserver unavailable: using -j1.  Add '+' to parent make rule.
   include/linux/init.h:1: warning: no structured comments found
   include/linux/kthread.h:26: warning: Excess function parameter '...' description in 'kthread_create'
   kernel/sys.c:1: warning: no structured comments found
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   include/drm/drm_drv.h:441: warning: No description found for parameter 'firstopen'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'open'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'preclose'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'postclose'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'lastclose'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'dma_ioctl'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'dma_quiescent'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'context_dtor'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'set_busid'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'irq_handler'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'irq_preinstall'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'irq_postinstall'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'irq_uninstall'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'debugfs_init'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'debugfs_cleanup'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_open_object'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_close_object'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'prime_handle_to_fd'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'prime_fd_to_handle'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_export'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_import'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_pin'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_unpin'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_res_obj'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_get_sg_table'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_import_sg_table'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_vmap'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_vunmap'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_prime_mmap'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'vgaarb_irq'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'gem_vm_ops'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'major'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'minor'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'patchlevel'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'name'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'desc'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'date'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'driver_features'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'dev_priv_size'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'ioctls'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'num_ioctls'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'fops'
   include/drm/drm_drv.h:441: warning: No description found for parameter 'legacy_dev_list'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'vm'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'node'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'size'
>> drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'offset'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'color'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3586: warning: No description found for parameter 'flags'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'vm'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'node'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'size'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'alignment'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'color'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'start'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'end'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3646: warning: No description found for parameter 'flags'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3587: warning: No description found for parameter 'vm'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3587: warning: No description found for parameter 'node'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3587: warning: No description found for parameter 'size'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3587: warning: No description found for parameter 'offset'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3587: warning: No description found for parameter 'color'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3587: warning: No description found for parameter 'flags'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'vm'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'node'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'size'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'alignment'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'color'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'start'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'end'
   drivers/gpu/drm/i915/i915_gem_gtt.c:3647: warning: No description found for parameter 'flags'
   drivers/media/dvb-core/dvb_frontend.h:677: warning: No description found for parameter 'refcount'
   drivers/char/tpm/tpm_vtpm_proxy.c:73: warning: No description found for parameter 'filp'
   drivers/char/tpm/tpm_vtpm_proxy.c:73: warning: No description found for parameter 'buf'
   drivers/char/tpm/tpm_vtpm_proxy.c:73: warning: No description found for parameter 'count'
   drivers/char/tpm/tpm_vtpm_proxy.c:73: warning: No description found for parameter 'off'
   drivers/char/tpm/tpm_vtpm_proxy.c:123: warning: No description found for parameter 'filp'
   drivers/char/tpm/tpm_vtpm_proxy.c:123: warning: No description found for parameter 'buf'
   drivers/char/tpm/tpm_vtpm_proxy.c:123: warning: No description found for parameter 'count'
   drivers/char/tpm/tpm_vtpm_proxy.c:123: warning: No description found for parameter 'off'
   drivers/char/tpm/tpm_vtpm_proxy.c:203: warning: No description found for parameter 'proxy_dev'
   sound/soc/soc-core.c:994: warning: No description found for parameter 'stream_name'
   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".
   include/net/cfg80211.h:3154: ERROR: Unexpected indentation.
   include/net/mac80211.h:3214: ERROR: Unexpected indentation.
   include/net/mac80211.h:3217: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:3219: ERROR: Unexpected indentation.
   include/net/mac80211.h:3220: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:1773: ERROR: Unexpected indentation.
   include/net/mac80211.h:1777: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/sched/fair.c:7587: WARNING: Inline emphasis start-string without end-string.
   kernel/time/timer.c:1240: ERROR: Unexpected indentation.
   kernel/time/timer.c:1242: ERROR: Unexpected indentation.
   kernel/time/timer.c:1243: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/wait.h:121: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/wait.h:124: ERROR: Unexpected indentation.
   include/linux/wait.h:126: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/time/hrtimer.c:1021: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/signal.c:317: WARNING: Inline literal start-string without end-string.
   drivers/message/fusion/mptbase.c:5051: WARNING: Definition list ends without a blank line; unexpected unindent.
   drivers/tty/serial/serial_core.c:1897: WARNING: Definition list ends without a blank line; unexpected unindent.
   include/linux/spi/spi.h:369: ERROR: Unexpected indentation.
   drivers/usb/core/message.c:481: ERROR: Unexpected indentation.
   drivers/usb/core/message.c:482: 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:2508: ERROR: Unknown target name: "snd_soc_daifmt".
   sound/core/jack.c:312: ERROR: Unknown target name: "snd_jack_btn".
   Documentation/translations/ko_KR/howto.rst:293: WARNING: Inline emphasis start-string without end-string.
   WARNING: dvipng command 'dvipng' cannot be run (needed for math display), check the imgmath_dvipng setting

vim +/offset +3586 drivers/gpu/drm/i915/i915_gem_gtt.c

  3570	 * i915_gem_gtt_reserve() tries to insert the @node at the exact @offset inside
  3571	 * the address space (using @size and @color). If the @node does not fit, it
  3572	 * tries to evict any overlapping nodes from the GTT, including any
  3573	 * neighbouring nodes if the colors do not match (to ensure guard pages between
  3574	 * differing domains). See i915_gem_evict_for_node() for the gory details
  3575	 * on the eviction algorithm. #PIN_NONBLOCK may used to prevent waiting on
  3576	 * evicting active overlapping objects, and any overlapping node that is pinned
  3577	 * or marked as unevictable will also result in failure.
  3578	 *
  3579	 * Returns: 0 on success, -ENOSPC if no suitable hole is found, -EINTR if
  3580	 * asked to wait for eviction and interrupted.
  3581	 */
  3582	int i915_gem_gtt_reserve(struct i915_address_space *vm,
  3583				 struct drm_mm_node *node,
  3584				 u64 size, u64 offset, unsigned long color,
  3585				 unsigned int flags)
> 3586	{
  3587		int err;
  3588	
  3589		GEM_BUG_ON(!size);
  3590		GEM_BUG_ON(!IS_ALIGNED(size, I915_GTT_PAGE_SIZE));
  3591		GEM_BUG_ON(!IS_ALIGNED(offset, I915_GTT_MIN_ALIGNMENT));
  3592		GEM_BUG_ON(range_overflows(offset, size, vm->total));
  3593	
  3594		node->size = size;

---
0-DAY kernel test infrastructure                Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all                   Intel Corporation
-------------- next part --------------
A non-text attachment was scrubbed...
Name: .config.gz
Type: application/gzip
Size: 6470 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20170112/346e9ea1/attachment-0001.gz>


More information about the dri-devel mailing list