[linuxtv-media:master 1648/1648] DockBook: include/media/videobuf2-core.h:146: warning: No description found for parameter 'm'

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   git://linuxtv.org/media_tree.git master
head:   2d7007153f0c9b1dd00c01894df7d26ddc32b79f
commit: 2d7007153f0c9b1dd00c01894df7d26ddc32b79f [1648/1648] [media] media: videobuf2: Restructure vb2_buffer
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   include/linux/init.h:1: warning: no structured comments found
   kernel/sys.c:1: warning: no structured comments found
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   drivers/dma-buf/reservation.c:1: warning: no structured comments found
   include/linux/reservation.h:1: warning: no structured comments found
   include/media/v4l2-dv-timings.h:29: warning: cannot understand function prototype: 'const struct v4l2_dv_timings v4l2_dv_timings_presets[]; '
   include/media/videobuf2-core.h:112: warning: No description found for parameter 'get_dmabuf'
>> include/media/videobuf2-core.h:146: warning: No description found for parameter 'm'
>> include/media/videobuf2-core.h:146: warning: Excess struct/union/enum/typedef member 'mem_offset' description in 'vb2_plane'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_alloc'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_put'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_get_dmabuf'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_get_userptr'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_put_userptr'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_prepare'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_finish'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_attach_dmabuf'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_detach_dmabuf'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_map_dmabuf'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_unmap_dmabuf'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_vaddr'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_cookie'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_num_users'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_mem_mmap'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_buf_init'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_buf_prepare'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_buf_finish'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_buf_cleanup'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_buf_queue'
   include/media/videobuf2-core.h:250: warning: No description found for parameter 'cnt_buf_done'
   drivers/media/dvb-core/dvbdev.h:199: warning: Excess function parameter 'device' description in 'dvb_register_device'
   drivers/media/dvb-core/dvbdev.h:199: warning: Excess function parameter 'adapter_nums' description in 'dvb_register_device'
   include/linux/spi/spi.h:71: warning: No description found for parameter 'lock'
   include/linux/spi/spi.h:71: warning: Excess struct/union/enum/typedef member 'clock' description in 'spi_statistics'
   include/linux/hsi/hsi.h:150: warning: Excess struct/union/enum/typedef member 'e_handler' description in 'hsi_client'
   include/linux/hsi/hsi.h:150: warning: Excess struct/union/enum/typedef member 'pclaimed' description in 'hsi_client'
   include/linux/hsi/hsi.h:150: warning: Excess struct/union/enum/typedef member 'nb' description in 'hsi_client'

vim +/m +146 include/media/videobuf2-core.h

e23ccc0a Pawel Osciak 2010-10-11  106  	void		*(*vaddr)(void *buf_priv);
e23ccc0a Pawel Osciak 2010-10-11  107  	void		*(*cookie)(void *buf_priv);
e23ccc0a Pawel Osciak 2010-10-11  108  
e23ccc0a Pawel Osciak 2010-10-11  109  	unsigned int	(*num_users)(void *buf_priv);
e23ccc0a Pawel Osciak 2010-10-11  110  
e23ccc0a Pawel Osciak 2010-10-11  111  	int		(*mmap)(void *buf_priv, struct vm_area_struct *vma);
e23ccc0a Pawel Osciak 2010-10-11 @112  };
e23ccc0a Pawel Osciak 2010-10-11  113  
2d700715 Junghak Sung 2015-09-22  114  /**
2d700715 Junghak Sung 2015-09-22  115   * struct vb2_plane - plane information
2d700715 Junghak Sung 2015-09-22  116   * @mem_priv:	private data with this plane
2d700715 Junghak Sung 2015-09-22  117   * @dbuf:	dma_buf - shared buffer object
2d700715 Junghak Sung 2015-09-22  118   * @dbuf_mapped:	flag to show whether dbuf is mapped or not
2d700715 Junghak Sung 2015-09-22  119   * @bytesused:	number of bytes occupied by data in the plane (payload)
2d700715 Junghak Sung 2015-09-22  120   * @length:	size of this plane (NOT the payload) in bytes
2d700715 Junghak Sung 2015-09-22  121   * @mem_offset:	when memory in the associated struct vb2_buffer is
2d700715 Junghak Sung 2015-09-22  122   *		VB2_MEMORY_MMAP, equals the offset from the start of
2d700715 Junghak Sung 2015-09-22  123   *		the device memory for this plane (or is a "cookie" that
2d700715 Junghak Sung 2015-09-22  124   *		should be passed to mmap() called on the video node)
2d700715 Junghak Sung 2015-09-22  125   * @userptr:	when memory is VB2_MEMORY_USERPTR, a userspace pointer
2d700715 Junghak Sung 2015-09-22  126   *		pointing to this plane
2d700715 Junghak Sung 2015-09-22  127   * @fd:		when memory is VB2_MEMORY_DMABUF, a userspace file
2d700715 Junghak Sung 2015-09-22  128   *		descriptor associated with this plane
2d700715 Junghak Sung 2015-09-22  129   * @data_offset:	offset in the plane to the start of data; usually 0,
2d700715 Junghak Sung 2015-09-22  130   *		unless there is a header in front of the data
2d700715 Junghak Sung 2015-09-22  131   * Should contain enough information to be able to cover all the fields
2d700715 Junghak Sung 2015-09-22  132   * of struct v4l2_plane at videodev2.h
2d700715 Junghak Sung 2015-09-22  133   */
e23ccc0a Pawel Osciak 2010-10-11  134  struct vb2_plane {
e23ccc0a Pawel Osciak 2010-10-11  135  	void			*mem_priv;
c5384048 Sumit Semwal 2012-06-14  136  	struct dma_buf		*dbuf;
c5384048 Sumit Semwal 2012-06-14  137  	unsigned int		dbuf_mapped;
2d700715 Junghak Sung 2015-09-22  138  	unsigned int		bytesused;
2d700715 Junghak Sung 2015-09-22  139  	unsigned int		length;
2d700715 Junghak Sung 2015-09-22  140  	union {
2d700715 Junghak Sung 2015-09-22  141  		unsigned int	offset;
2d700715 Junghak Sung 2015-09-22  142  		unsigned long	userptr;
2d700715 Junghak Sung 2015-09-22  143  		int		fd;
2d700715 Junghak Sung 2015-09-22  144  	} m;
2d700715 Junghak Sung 2015-09-22  145  	unsigned int		data_offset;
e23ccc0a Pawel Osciak 2010-10-11 @146  };
e23ccc0a Pawel Osciak 2010-10-11  147  
e23ccc0a Pawel Osciak 2010-10-11  148  /**
e23ccc0a Pawel Osciak 2010-10-11  149   * enum vb2_io_modes - queue access methods

:::::: The code at line 146 was first introduced by commit
:::::: e23ccc0ad9258634e6d52cedf473b35dc34416c7 [media] v4l: add videobuf2 Video for Linux 2 driver framework

:::::: TO: Pawel Osciak <p.osciak@xxxxxxxxxxx>
:::::: CC: Mauro Carvalho Chehab <mchehab@xxxxxxxxxx>

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

Attachment: .config.gz
Description: Binary data


[Index of Archives]     [Linux Input]     [Video for Linux]     [Gstreamer Embedded]     [Mplayer Users]     [Linux USB Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Yosemite Backpacking]
  Powered by Linux