Hi Mauro, [auto build test WARNING on v4.3-rc4 -- if it's inappropriate base, please ignore]
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/v4l2-dv-timings.h:147: warning: No description found for
parameter 'frame_height'
include/media/v4l2-dv-timings.h:147: warning: No description found for
parameter 'hfreq'
include/media/v4l2-dv-timings.h:147: warning: No description found for
parameter 'vsync'
include/media/v4l2-dv-timings.h:147: warning: No description found for
parameter 'active_width'
include/media/v4l2-dv-timings.h:147: warning: No description found for
parameter 'polarities'
include/media/v4l2-dv-timings.h:147: warning: No description found for
parameter 'interlaced'
include/media/v4l2-dv-timings.h:147: warning: No description found for
parameter 'fmt'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'frame_height'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'hfreq'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'vsync'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'polarities'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'interlaced'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'aspect'
include/media/v4l2-dv-timings.h:171: warning: No description found for
parameter 'fmt'
include/media/v4l2-dv-timings.h:184: warning: No description found for
parameter 'hor_landscape'
include/media/v4l2-dv-timings.h:184: warning: No description found for
parameter 'vert_portrait'
include/media/videobuf2-core.h:112: warning: No description found for
parameter 'get_dmabuf'
>> include/media/videobuf2-core.h:233: warning: Excess
>> struct/union/enum/typedef member 'state' description in 'vb2_buffer'
>> include/media/videobuf2-core.h:233: warning: Excess
>> struct/union/enum/typedef member 'queued_entry' description in 'vb2_buffer'
>> include/media/videobuf2-core.h:233: warning: Excess
>> struct/union/enum/typedef member 'done_entry' description in 'vb2_buffer'
>> include/media/videobuf2-core.h:233: warning: Excess
>> struct/union/enum/typedef member 'planes' description in 'vb2_buffer'
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/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 +233 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
e23ccc0a Pawel Osciak 2010-10-11 114 struct vb2_plane {
e23ccc0a Pawel Osciak 2010-10-11 115 void
*mem_priv;
c5384048 Sumit Semwal 2012-06-14 116 struct dma_buf
*dbuf;
c5384048 Sumit Semwal 2012-06-14 117 unsigned int
dbuf_mapped;
e23ccc0a Pawel Osciak 2010-10-11 118 };
e23ccc0a Pawel Osciak 2010-10-11 119
e23ccc0a Pawel Osciak 2010-10-11 120 /**
e23ccc0a Pawel Osciak 2010-10-11 121 * enum vb2_io_modes - queue
access methods
e23ccc0a Pawel Osciak 2010-10-11 122 * @VB2_MMAP: driver
supports MMAP with streaming API
e23ccc0a Pawel Osciak 2010-10-11 123 * @VB2_USERPTR: driver
supports USERPTR with streaming API
e23ccc0a Pawel Osciak 2010-10-11 124 * @VB2_READ: driver
supports read() style access
e23ccc0a Pawel Osciak 2010-10-11 125 * @VB2_WRITE: driver
supports write() style access
c5384048 Sumit Semwal 2012-06-14 126 * @VB2_DMABUF: driver
supports DMABUF with streaming API
e23ccc0a Pawel Osciak 2010-10-11 127 */
e23ccc0a Pawel Osciak 2010-10-11 128 enum vb2_io_modes {
e23ccc0a Pawel Osciak 2010-10-11 129 VB2_MMAP = (1 <<
0),
e23ccc0a Pawel Osciak 2010-10-11 130 VB2_USERPTR = (1 <<
1),
e23ccc0a Pawel Osciak 2010-10-11 131 VB2_READ = (1 <<
2),
e23ccc0a Pawel Osciak 2010-10-11 132 VB2_WRITE = (1 <<
3),
c5384048 Sumit Semwal 2012-06-14 133 VB2_DMABUF = (1 <<
4),
e23ccc0a Pawel Osciak 2010-10-11 134 };
e23ccc0a Pawel Osciak 2010-10-11 135
e23ccc0a Pawel Osciak 2010-10-11 136 /**
e23ccc0a Pawel Osciak 2010-10-11 137 * enum vb2_buffer_state -
current video buffer state
e23ccc0a Pawel Osciak 2010-10-11 138 * @VB2_BUF_STATE_DEQUEUED:
buffer under userspace control
b18a8ff2 Hans Verkuil 2013-12-13 139 * @VB2_BUF_STATE_PREPARING:
buffer is being prepared in videobuf
ebc087d0 Guennadi Liakhovetski 2011-08-31 140 * @VB2_BUF_STATE_PREPARED:
buffer prepared in videobuf and by the driver
e23ccc0a Pawel Osciak 2010-10-11 141 * @VB2_BUF_STATE_QUEUED:
buffer queued in videobuf, but not in driver
6d058c56 Sakari Ailus 2015-07-03 142 * @VB2_BUF_STATE_REQUEUEING:
re-queue a buffer to the driver
e23ccc0a Pawel Osciak 2010-10-11 143 * @VB2_BUF_STATE_ACTIVE:
buffer queued in driver and possibly used
e23ccc0a Pawel Osciak 2010-10-11 144 *
in a hardware operation
e23ccc0a Pawel Osciak 2010-10-11 145 * @VB2_BUF_STATE_DONE:
buffer returned from driver to videobuf, but
e23ccc0a Pawel Osciak 2010-10-11 146 *
not yet dequeued to userspace
e23ccc0a Pawel Osciak 2010-10-11 147 * @VB2_BUF_STATE_ERROR:
same as above, but the operation on the buffer
e23ccc0a Pawel Osciak 2010-10-11 148 *
has ended with an error, which will be reported
e23ccc0a Pawel Osciak 2010-10-11 149 *
to the userspace when it is dequeued
e23ccc0a Pawel Osciak 2010-10-11 150 */
e23ccc0a Pawel Osciak 2010-10-11 151 enum vb2_buffer_state {
e23ccc0a Pawel Osciak 2010-10-11 152 VB2_BUF_STATE_DEQUEUED,
b18a8ff2 Hans Verkuil 2013-12-13 153 VB2_BUF_STATE_PREPARING,
ebc087d0 Guennadi Liakhovetski 2011-08-31 154 VB2_BUF_STATE_PREPARED,
e23ccc0a Pawel Osciak 2010-10-11 155 VB2_BUF_STATE_QUEUED,
6d058c56 Sakari Ailus 2015-07-03 156
VB2_BUF_STATE_REQUEUEING,
e23ccc0a Pawel Osciak 2010-10-11 157 VB2_BUF_STATE_ACTIVE,
e23ccc0a Pawel Osciak 2010-10-11 158 VB2_BUF_STATE_DONE,
e23ccc0a Pawel Osciak 2010-10-11 159 VB2_BUF_STATE_ERROR,
e23ccc0a Pawel Osciak 2010-10-11 160 };
e23ccc0a Pawel Osciak 2010-10-11 161
e23ccc0a Pawel Osciak 2010-10-11 162 struct vb2_queue;
e23ccc0a Pawel Osciak 2010-10-11 163
e23ccc0a Pawel Osciak 2010-10-11 164 /**
e23ccc0a Pawel Osciak 2010-10-11 165 * struct vb2_buffer -
represents a video buffer
e23ccc0a Pawel Osciak 2010-10-11 166 * @v4l2_buf: struct
v4l2_buffer associated with this buffer; can
e23ccc0a Pawel Osciak 2010-10-11 167 * be read
by the driver and relevant entries can be
e23ccc0a Pawel Osciak 2010-10-11 168 * changed
by the driver in case of CAPTURE types
e23ccc0a Pawel Osciak 2010-10-11 169 * (such
as timestamp)
e23ccc0a Pawel Osciak 2010-10-11 170 * @v4l2_planes: struct
v4l2_planes associated with this buffer; can
e23ccc0a Pawel Osciak 2010-10-11 171 * be read
by the driver and relevant entries can be
e23ccc0a Pawel Osciak 2010-10-11 172 * changed
by the driver in case of CAPTURE types
e23ccc0a Pawel Osciak 2010-10-11 173 * (such
as bytesused); NOTE that even for single-planar
e23ccc0a Pawel Osciak 2010-10-11 174 * types,
the v4l2_planes[0] struct should be used
e23ccc0a Pawel Osciak 2010-10-11 175 * instead
of v4l2_buf for filling bytesused - drivers
e23ccc0a Pawel Osciak 2010-10-11 176 * should
use the vb2_set_plane_payload() function for that
e23ccc0a Pawel Osciak 2010-10-11 177 * @vb2_queue: the
queue to which this driver belongs
e23ccc0a Pawel Osciak 2010-10-11 178 * @num_planes: number
of planes in the buffer
e23ccc0a Pawel Osciak 2010-10-11 179 * on an
internal driver queue
e23ccc0a Pawel Osciak 2010-10-11 180 * @state: current
buffer state; do not change
e23ccc0a Pawel Osciak 2010-10-11 181 * @queued_entry: entry
on the queued buffers list, which holds all
e23ccc0a Pawel Osciak 2010-10-11 182 * buffers
queued from userspace
e23ccc0a Pawel Osciak 2010-10-11 183 * @done_entry: entry
on the list that stores all buffers ready to
e23ccc0a Pawel Osciak 2010-10-11 184 * be
dequeued to userspace
e23ccc0a Pawel Osciak 2010-10-11 185 * @planes: private
per-plane information; do not change
e23ccc0a Pawel Osciak 2010-10-11 186 */
e23ccc0a Pawel Osciak 2010-10-11 187 struct vb2_buffer {
e23ccc0a Pawel Osciak 2010-10-11 188 struct v4l2_buffer
v4l2_buf;
e23ccc0a Pawel Osciak 2010-10-11 189 struct v4l2_plane
v4l2_planes[VIDEO_MAX_PLANES];
e23ccc0a Pawel Osciak 2010-10-11 190
e23ccc0a Pawel Osciak 2010-10-11 191 struct vb2_queue
*vb2_queue;
e23ccc0a Pawel Osciak 2010-10-11 192
e23ccc0a Pawel Osciak 2010-10-11 193 unsigned int
num_planes;
e23ccc0a Pawel Osciak 2010-10-11 194
e23ccc0a Pawel Osciak 2010-10-11 195 /* Private: internal use only */
e23ccc0a Pawel Osciak 2010-10-11 196 enum vb2_buffer_state
state;
e23ccc0a Pawel Osciak 2010-10-11 197
e23ccc0a Pawel Osciak 2010-10-11 198 struct list_head
queued_entry;
e23ccc0a Pawel Osciak 2010-10-11 199 struct list_head
done_entry;
e23ccc0a Pawel Osciak 2010-10-11 200
e23ccc0a Pawel Osciak 2010-10-11 201 struct vb2_plane
planes[VIDEO_MAX_PLANES];
b5b4541e Hans Verkuil 2014-01-29 202
b5b4541e Hans Verkuil 2014-01-29 203 #ifdef CONFIG_VIDEO_ADV_DEBUG
b5b4541e Hans Verkuil 2014-01-29 204 /*
b5b4541e Hans Verkuil 2014-01-29 205 * Counters for how
often these buffer-related ops are
b5b4541e Hans Verkuil 2014-01-29 206 * called. Used to
check for unbalanced ops.
b5b4541e Hans Verkuil 2014-01-29 207 */
b5b4541e Hans Verkuil 2014-01-29 208 u32
cnt_mem_alloc;
b5b4541e Hans Verkuil 2014-01-29 209 u32
cnt_mem_put;
b5b4541e Hans Verkuil 2014-01-29 210 u32
cnt_mem_get_dmabuf;
b5b4541e Hans Verkuil 2014-01-29 211 u32
cnt_mem_get_userptr;
b5b4541e Hans Verkuil 2014-01-29 212 u32
cnt_mem_put_userptr;
b5b4541e Hans Verkuil 2014-01-29 213 u32
cnt_mem_prepare;
b5b4541e Hans Verkuil 2014-01-29 214 u32
cnt_mem_finish;
b5b4541e Hans Verkuil 2014-01-29 215 u32
cnt_mem_attach_dmabuf;
b5b4541e Hans Verkuil 2014-01-29 216 u32
cnt_mem_detach_dmabuf;
b5b4541e Hans Verkuil 2014-01-29 217 u32
cnt_mem_map_dmabuf;
b5b4541e Hans Verkuil 2014-01-29 218 u32
cnt_mem_unmap_dmabuf;
b5b4541e Hans Verkuil 2014-01-29 219 u32
cnt_mem_vaddr;
b5b4541e Hans Verkuil 2014-01-29 220 u32
cnt_mem_cookie;
b5b4541e Hans Verkuil 2014-01-29 221 u32
cnt_mem_num_users;
b5b4541e Hans Verkuil 2014-01-29 222 u32
cnt_mem_mmap;
b5b4541e Hans Verkuil 2014-01-29 223
b5b4541e Hans Verkuil 2014-01-29 224 u32
cnt_buf_init;
b5b4541e Hans Verkuil 2014-01-29 225 u32
cnt_buf_prepare;
b5b4541e Hans Verkuil 2014-01-29 226 u32
cnt_buf_finish;
b5b4541e Hans Verkuil 2014-01-29 227 u32
cnt_buf_cleanup;
b5b4541e Hans Verkuil 2014-01-29 228 u32
cnt_buf_queue;
b5b4541e Hans Verkuil 2014-01-29 229
b5b4541e Hans Verkuil 2014-01-29 230 /* This counts the
number of calls to vb2_buffer_done() */
b5b4541e Hans Verkuil 2014-01-29 231 u32
cnt_buf_done;
b5b4541e Hans Verkuil 2014-01-29 232 #endif
e23ccc0a Pawel Osciak 2010-10-11 @233 };
e23ccc0a Pawel Osciak 2010-10-11 234
e23ccc0a Pawel Osciak 2010-10-11 235 /**
e23ccc0a Pawel Osciak 2010-10-11 236 * struct vb2_ops -
driver-specific callbacks
:::::: The code at line 233 was first introduced by commit
:::::: e23ccc0ad9258634e6d52cedf473b35dc34416c7 [media] v4l: add videobuf2
Video for Linux 2 driver framework
:::::: TO: Pawel Osciak <p.osc...@samsung.com>
:::::: CC: Mauro Carvalho Chehab <mche...@redhat.com>
---
0-DAY kernel test infrastructure Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all Intel Corporation
.config.gz
Description: Binary data
