]>
Commit | Line | Data |
---|---|---|
c139990e JS |
1 | /* |
2 | * videobuf2-v4l2.c - V4L2 driver helper framework | |
3 | * | |
4 | * Copyright (C) 2010 Samsung Electronics | |
5 | * | |
6 | * Author: Pawel Osciak <pawel@osciak.com> | |
7 | * Marek Szyprowski <m.szyprowski@samsung.com> | |
8 | * | |
9 | * The vb2_thread implementation was based on code from videobuf-dvb.c: | |
10 | * (c) 2004 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs] | |
11 | * | |
12 | * This program is free software; you can redistribute it and/or modify | |
13 | * it under the terms of the GNU General Public License as published by | |
14 | * the Free Software Foundation. | |
15 | */ | |
16 | ||
17 | #include <linux/err.h> | |
18 | #include <linux/kernel.h> | |
19 | #include <linux/module.h> | |
20 | #include <linux/mm.h> | |
21 | #include <linux/poll.h> | |
22 | #include <linux/slab.h> | |
23 | #include <linux/sched.h> | |
24 | #include <linux/freezer.h> | |
25 | #include <linux/kthread.h> | |
26 | ||
3c5be988 JS |
27 | #include <media/v4l2-dev.h> |
28 | #include <media/v4l2-fh.h> | |
29 | #include <media/v4l2-event.h> | |
30 | #include <media/v4l2-common.h> | |
31 | ||
c139990e JS |
32 | #include <media/videobuf2-v4l2.h> |
33 | ||
af3bac1a JS |
34 | static int debug; |
35 | module_param(debug, int, 0644); | |
36 | ||
37 | #define dprintk(level, fmt, arg...) \ | |
38 | do { \ | |
39 | if (debug >= level) \ | |
40 | pr_info("vb2-v4l2: %s: " fmt, __func__, ## arg); \ | |
41 | } while (0) | |
3c5be988 JS |
42 | |
43 | /* Flags that are set by the vb2 core */ | |
44 | #define V4L2_BUFFER_MASK_FLAGS (V4L2_BUF_FLAG_MAPPED | V4L2_BUF_FLAG_QUEUED | \ | |
45 | V4L2_BUF_FLAG_DONE | V4L2_BUF_FLAG_ERROR | \ | |
46 | V4L2_BUF_FLAG_PREPARED | \ | |
47 | V4L2_BUF_FLAG_TIMESTAMP_MASK) | |
48 | /* Output buffer flags that should be passed on to the driver */ | |
49 | #define V4L2_BUFFER_OUT_FLAGS (V4L2_BUF_FLAG_PFRAME | V4L2_BUF_FLAG_BFRAME | \ | |
50 | V4L2_BUF_FLAG_KEYFRAME | V4L2_BUF_FLAG_TIMECODE) | |
51 | ||
52 | /** | |
53 | * __verify_planes_array() - verify that the planes array passed in struct | |
54 | * v4l2_buffer from userspace can be safely used | |
55 | */ | |
56 | static int __verify_planes_array(struct vb2_buffer *vb, const struct v4l2_buffer *b) | |
57 | { | |
58 | if (!V4L2_TYPE_IS_MULTIPLANAR(b->type)) | |
59 | return 0; | |
60 | ||
61 | /* Is memory for copying plane information present? */ | |
e88a3f81 | 62 | if (b->m.planes == NULL) { |
3c5be988 JS |
63 | dprintk(1, "multi-planar buffer passed but " |
64 | "planes array not provided\n"); | |
65 | return -EINVAL; | |
66 | } | |
67 | ||
68 | if (b->length < vb->num_planes || b->length > VB2_MAX_PLANES) { | |
69 | dprintk(1, "incorrect planes array length, " | |
70 | "expected %d, got %d\n", vb->num_planes, b->length); | |
71 | return -EINVAL; | |
72 | } | |
73 | ||
74 | return 0; | |
75 | } | |
76 | ||
83934b75 SA |
77 | static int __verify_planes_array_core(struct vb2_buffer *vb, const void *pb) |
78 | { | |
79 | return __verify_planes_array(vb, pb); | |
80 | } | |
81 | ||
3c5be988 JS |
82 | /** |
83 | * __verify_length() - Verify that the bytesused value for each plane fits in | |
84 | * the plane length and that the data offset doesn't exceed the bytesused value. | |
85 | */ | |
86 | static int __verify_length(struct vb2_buffer *vb, const struct v4l2_buffer *b) | |
87 | { | |
88 | unsigned int length; | |
89 | unsigned int bytesused; | |
90 | unsigned int plane; | |
91 | ||
92 | if (!V4L2_TYPE_IS_OUTPUT(b->type)) | |
93 | return 0; | |
94 | ||
95 | if (V4L2_TYPE_IS_MULTIPLANAR(b->type)) { | |
96 | for (plane = 0; plane < vb->num_planes; ++plane) { | |
97 | length = (b->memory == VB2_MEMORY_USERPTR || | |
98 | b->memory == VB2_MEMORY_DMABUF) | |
99 | ? b->m.planes[plane].length | |
100 | : vb->planes[plane].length; | |
101 | bytesused = b->m.planes[plane].bytesused | |
102 | ? b->m.planes[plane].bytesused : length; | |
103 | ||
104 | if (b->m.planes[plane].bytesused > length) | |
105 | return -EINVAL; | |
106 | ||
107 | if (b->m.planes[plane].data_offset > 0 && | |
108 | b->m.planes[plane].data_offset >= bytesused) | |
109 | return -EINVAL; | |
110 | } | |
111 | } else { | |
112 | length = (b->memory == VB2_MEMORY_USERPTR) | |
113 | ? b->length : vb->planes[0].length; | |
114 | ||
115 | if (b->bytesused > length) | |
116 | return -EINVAL; | |
117 | } | |
118 | ||
119 | return 0; | |
120 | } | |
121 | ||
10cc3b1e | 122 | static void __copy_timestamp(struct vb2_buffer *vb, const void *pb) |
3c5be988 JS |
123 | { |
124 | const struct v4l2_buffer *b = pb; | |
125 | struct vb2_v4l2_buffer *vbuf = to_vb2_v4l2_buffer(vb); | |
126 | struct vb2_queue *q = vb->vb2_queue; | |
127 | ||
128 | if (q->is_output) { | |
129 | /* | |
130 | * For output buffers copy the timestamp if needed, | |
131 | * and the timecode field and flag if needed. | |
132 | */ | |
959c3ef3 | 133 | if (q->copy_timestamp) |
d6dd645e | 134 | vb->timestamp = timeval_to_ns(&b->timestamp); |
3c5be988 JS |
135 | vbuf->flags |= b->flags & V4L2_BUF_FLAG_TIMECODE; |
136 | if (b->flags & V4L2_BUF_FLAG_TIMECODE) | |
137 | vbuf->timecode = b->timecode; | |
138 | } | |
3c5be988 JS |
139 | }; |
140 | ||
141 | static void vb2_warn_zero_bytesused(struct vb2_buffer *vb) | |
142 | { | |
143 | static bool check_once; | |
144 | ||
145 | if (check_once) | |
146 | return; | |
147 | ||
148 | check_once = true; | |
149 | WARN_ON(1); | |
150 | ||
151 | pr_warn("use of bytesused == 0 is deprecated and will be removed in the future,\n"); | |
152 | if (vb->vb2_queue->allow_zero_bytesused) | |
153 | pr_warn("use VIDIOC_DECODER_CMD(V4L2_DEC_CMD_STOP) instead.\n"); | |
154 | else | |
155 | pr_warn("use the actual size instead.\n"); | |
156 | } | |
157 | ||
158 | static int vb2_queue_or_prepare_buf(struct vb2_queue *q, struct v4l2_buffer *b, | |
159 | const char *opname) | |
160 | { | |
161 | if (b->type != q->type) { | |
162 | dprintk(1, "%s: invalid buffer type\n", opname); | |
163 | return -EINVAL; | |
164 | } | |
165 | ||
166 | if (b->index >= q->num_buffers) { | |
167 | dprintk(1, "%s: buffer index out of range\n", opname); | |
168 | return -EINVAL; | |
169 | } | |
170 | ||
171 | if (q->bufs[b->index] == NULL) { | |
172 | /* Should never happen */ | |
173 | dprintk(1, "%s: buffer is NULL\n", opname); | |
174 | return -EINVAL; | |
175 | } | |
176 | ||
177 | if (b->memory != q->memory) { | |
178 | dprintk(1, "%s: invalid memory type\n", opname); | |
179 | return -EINVAL; | |
180 | } | |
181 | ||
182 | return __verify_planes_array(q->bufs[b->index], b); | |
183 | } | |
184 | ||
185 | /** | |
186 | * __fill_v4l2_buffer() - fill in a struct v4l2_buffer with information to be | |
187 | * returned to userspace | |
188 | */ | |
10cc3b1e | 189 | static void __fill_v4l2_buffer(struct vb2_buffer *vb, void *pb) |
3c5be988 JS |
190 | { |
191 | struct v4l2_buffer *b = pb; | |
192 | struct vb2_v4l2_buffer *vbuf = to_vb2_v4l2_buffer(vb); | |
193 | struct vb2_queue *q = vb->vb2_queue; | |
194 | unsigned int plane; | |
195 | ||
196 | /* Copy back data such as timestamp, flags, etc. */ | |
197 | b->index = vb->index; | |
198 | b->type = vb->type; | |
199 | b->memory = vb->memory; | |
200 | b->bytesused = 0; | |
201 | ||
202 | b->flags = vbuf->flags; | |
203 | b->field = vbuf->field; | |
d6dd645e | 204 | b->timestamp = ns_to_timeval(vb->timestamp); |
3c5be988 JS |
205 | b->timecode = vbuf->timecode; |
206 | b->sequence = vbuf->sequence; | |
207 | b->reserved2 = 0; | |
208 | b->reserved = 0; | |
209 | ||
210 | if (q->is_multiplanar) { | |
211 | /* | |
212 | * Fill in plane-related data if userspace provided an array | |
213 | * for it. The caller has already verified memory and size. | |
214 | */ | |
215 | b->length = vb->num_planes; | |
216 | for (plane = 0; plane < vb->num_planes; ++plane) { | |
217 | struct v4l2_plane *pdst = &b->m.planes[plane]; | |
218 | struct vb2_plane *psrc = &vb->planes[plane]; | |
219 | ||
220 | pdst->bytesused = psrc->bytesused; | |
221 | pdst->length = psrc->length; | |
222 | if (q->memory == VB2_MEMORY_MMAP) | |
223 | pdst->m.mem_offset = psrc->m.offset; | |
224 | else if (q->memory == VB2_MEMORY_USERPTR) | |
225 | pdst->m.userptr = psrc->m.userptr; | |
226 | else if (q->memory == VB2_MEMORY_DMABUF) | |
227 | pdst->m.fd = psrc->m.fd; | |
228 | pdst->data_offset = psrc->data_offset; | |
229 | memset(pdst->reserved, 0, sizeof(pdst->reserved)); | |
230 | } | |
231 | } else { | |
232 | /* | |
233 | * We use length and offset in v4l2_planes array even for | |
234 | * single-planar buffers, but userspace does not. | |
235 | */ | |
236 | b->length = vb->planes[0].length; | |
237 | b->bytesused = vb->planes[0].bytesused; | |
238 | if (q->memory == VB2_MEMORY_MMAP) | |
239 | b->m.offset = vb->planes[0].m.offset; | |
240 | else if (q->memory == VB2_MEMORY_USERPTR) | |
241 | b->m.userptr = vb->planes[0].m.userptr; | |
242 | else if (q->memory == VB2_MEMORY_DMABUF) | |
243 | b->m.fd = vb->planes[0].m.fd; | |
244 | } | |
245 | ||
246 | /* | |
247 | * Clear any buffer state related flags. | |
248 | */ | |
249 | b->flags &= ~V4L2_BUFFER_MASK_FLAGS; | |
250 | b->flags |= q->timestamp_flags & V4L2_BUF_FLAG_TIMESTAMP_MASK; | |
959c3ef3 | 251 | if (!q->copy_timestamp) { |
3c5be988 JS |
252 | /* |
253 | * For non-COPY timestamps, drop timestamp source bits | |
254 | * and obtain the timestamp source from the queue. | |
255 | */ | |
256 | b->flags &= ~V4L2_BUF_FLAG_TSTAMP_SRC_MASK; | |
257 | b->flags |= q->timestamp_flags & V4L2_BUF_FLAG_TSTAMP_SRC_MASK; | |
258 | } | |
259 | ||
260 | switch (vb->state) { | |
261 | case VB2_BUF_STATE_QUEUED: | |
262 | case VB2_BUF_STATE_ACTIVE: | |
263 | b->flags |= V4L2_BUF_FLAG_QUEUED; | |
264 | break; | |
265 | case VB2_BUF_STATE_ERROR: | |
266 | b->flags |= V4L2_BUF_FLAG_ERROR; | |
267 | /* fall through */ | |
268 | case VB2_BUF_STATE_DONE: | |
269 | b->flags |= V4L2_BUF_FLAG_DONE; | |
270 | break; | |
271 | case VB2_BUF_STATE_PREPARED: | |
272 | b->flags |= V4L2_BUF_FLAG_PREPARED; | |
273 | break; | |
274 | case VB2_BUF_STATE_PREPARING: | |
275 | case VB2_BUF_STATE_DEQUEUED: | |
276 | case VB2_BUF_STATE_REQUEUEING: | |
277 | /* nothing */ | |
278 | break; | |
279 | } | |
280 | ||
281 | if (vb2_buffer_in_use(q, vb)) | |
282 | b->flags |= V4L2_BUF_FLAG_MAPPED; | |
283 | ||
dcbc216d JS |
284 | if (!q->is_output && |
285 | b->flags & V4L2_BUF_FLAG_DONE && | |
286 | b->flags & V4L2_BUF_FLAG_LAST) | |
287 | q->last_buffer_dequeued = true; | |
3c5be988 JS |
288 | } |
289 | ||
290 | /** | |
291 | * __fill_vb2_buffer() - fill a vb2_buffer with information provided in a | |
292 | * v4l2_buffer by the userspace. It also verifies that struct | |
293 | * v4l2_buffer has a valid number of planes. | |
294 | */ | |
295 | static int __fill_vb2_buffer(struct vb2_buffer *vb, | |
296 | const void *pb, struct vb2_plane *planes) | |
297 | { | |
298 | struct vb2_queue *q = vb->vb2_queue; | |
299 | const struct v4l2_buffer *b = pb; | |
300 | struct vb2_v4l2_buffer *vbuf = to_vb2_v4l2_buffer(vb); | |
301 | unsigned int plane; | |
302 | int ret; | |
303 | ||
304 | ret = __verify_length(vb, b); | |
305 | if (ret < 0) { | |
306 | dprintk(1, "plane parameters verification failed: %d\n", ret); | |
307 | return ret; | |
308 | } | |
309 | if (b->field == V4L2_FIELD_ALTERNATE && q->is_output) { | |
310 | /* | |
311 | * If the format's field is ALTERNATE, then the buffer's field | |
312 | * should be either TOP or BOTTOM, not ALTERNATE since that | |
313 | * makes no sense. The driver has to know whether the | |
314 | * buffer represents a top or a bottom field in order to | |
315 | * program any DMA correctly. Using ALTERNATE is wrong, since | |
316 | * that just says that it is either a top or a bottom field, | |
317 | * but not which of the two it is. | |
318 | */ | |
319 | dprintk(1, "the field is incorrectly set to ALTERNATE " | |
320 | "for an output buffer\n"); | |
321 | return -EINVAL; | |
322 | } | |
d6dd645e | 323 | vb->timestamp = 0; |
3c5be988 JS |
324 | vbuf->sequence = 0; |
325 | ||
326 | if (V4L2_TYPE_IS_MULTIPLANAR(b->type)) { | |
327 | if (b->memory == VB2_MEMORY_USERPTR) { | |
328 | for (plane = 0; plane < vb->num_planes; ++plane) { | |
329 | planes[plane].m.userptr = | |
330 | b->m.planes[plane].m.userptr; | |
331 | planes[plane].length = | |
332 | b->m.planes[plane].length; | |
333 | } | |
334 | } | |
335 | if (b->memory == VB2_MEMORY_DMABUF) { | |
336 | for (plane = 0; plane < vb->num_planes; ++plane) { | |
337 | planes[plane].m.fd = | |
338 | b->m.planes[plane].m.fd; | |
339 | planes[plane].length = | |
340 | b->m.planes[plane].length; | |
341 | } | |
342 | } | |
343 | ||
344 | /* Fill in driver-provided information for OUTPUT types */ | |
345 | if (V4L2_TYPE_IS_OUTPUT(b->type)) { | |
346 | /* | |
347 | * Will have to go up to b->length when API starts | |
348 | * accepting variable number of planes. | |
349 | * | |
350 | * If bytesused == 0 for the output buffer, then fall | |
351 | * back to the full buffer size. In that case | |
352 | * userspace clearly never bothered to set it and | |
353 | * it's a safe assumption that they really meant to | |
354 | * use the full plane sizes. | |
355 | * | |
356 | * Some drivers, e.g. old codec drivers, use bytesused == 0 | |
357 | * as a way to indicate that streaming is finished. | |
358 | * In that case, the driver should use the | |
359 | * allow_zero_bytesused flag to keep old userspace | |
360 | * applications working. | |
361 | */ | |
362 | for (plane = 0; plane < vb->num_planes; ++plane) { | |
363 | struct vb2_plane *pdst = &planes[plane]; | |
364 | struct v4l2_plane *psrc = &b->m.planes[plane]; | |
365 | ||
366 | if (psrc->bytesused == 0) | |
367 | vb2_warn_zero_bytesused(vb); | |
368 | ||
369 | if (vb->vb2_queue->allow_zero_bytesused) | |
370 | pdst->bytesused = psrc->bytesused; | |
371 | else | |
372 | pdst->bytesused = psrc->bytesused ? | |
373 | psrc->bytesused : pdst->length; | |
374 | pdst->data_offset = psrc->data_offset; | |
375 | } | |
376 | } | |
377 | } else { | |
378 | /* | |
379 | * Single-planar buffers do not use planes array, | |
380 | * so fill in relevant v4l2_buffer struct fields instead. | |
381 | * In videobuf we use our internal V4l2_planes struct for | |
382 | * single-planar buffers as well, for simplicity. | |
383 | * | |
384 | * If bytesused == 0 for the output buffer, then fall back | |
385 | * to the full buffer size as that's a sensible default. | |
386 | * | |
387 | * Some drivers, e.g. old codec drivers, use bytesused == 0 as | |
388 | * a way to indicate that streaming is finished. In that case, | |
389 | * the driver should use the allow_zero_bytesused flag to keep | |
390 | * old userspace applications working. | |
391 | */ | |
392 | if (b->memory == VB2_MEMORY_USERPTR) { | |
393 | planes[0].m.userptr = b->m.userptr; | |
394 | planes[0].length = b->length; | |
395 | } | |
396 | ||
397 | if (b->memory == VB2_MEMORY_DMABUF) { | |
398 | planes[0].m.fd = b->m.fd; | |
399 | planes[0].length = b->length; | |
400 | } | |
401 | ||
402 | if (V4L2_TYPE_IS_OUTPUT(b->type)) { | |
403 | if (b->bytesused == 0) | |
404 | vb2_warn_zero_bytesused(vb); | |
405 | ||
406 | if (vb->vb2_queue->allow_zero_bytesused) | |
407 | planes[0].bytesused = b->bytesused; | |
408 | else | |
409 | planes[0].bytesused = b->bytesused ? | |
410 | b->bytesused : planes[0].length; | |
411 | } else | |
412 | planes[0].bytesused = 0; | |
413 | ||
414 | } | |
415 | ||
416 | /* Zero flags that the vb2 core handles */ | |
417 | vbuf->flags = b->flags & ~V4L2_BUFFER_MASK_FLAGS; | |
959c3ef3 | 418 | if (!vb->vb2_queue->copy_timestamp || !V4L2_TYPE_IS_OUTPUT(b->type)) { |
3c5be988 JS |
419 | /* |
420 | * Non-COPY timestamps and non-OUTPUT queues will get | |
421 | * their timestamp and timestamp source flags from the | |
422 | * queue. | |
423 | */ | |
424 | vbuf->flags &= ~V4L2_BUF_FLAG_TSTAMP_SRC_MASK; | |
425 | } | |
426 | ||
427 | if (V4L2_TYPE_IS_OUTPUT(b->type)) { | |
428 | /* | |
429 | * For output buffers mask out the timecode flag: | |
dfadf026 | 430 | * this will be handled later in vb2_qbuf(). |
3c5be988 JS |
431 | * The 'field' is valid metadata for this output buffer |
432 | * and so that needs to be copied here. | |
433 | */ | |
434 | vbuf->flags &= ~V4L2_BUF_FLAG_TIMECODE; | |
435 | vbuf->field = b->field; | |
436 | } else { | |
437 | /* Zero any output buffer flags as this is a capture buffer */ | |
438 | vbuf->flags &= ~V4L2_BUFFER_OUT_FLAGS; | |
439 | } | |
440 | ||
441 | return 0; | |
442 | } | |
443 | ||
444 | static const struct vb2_buf_ops v4l2_buf_ops = { | |
83934b75 | 445 | .verify_planes_array = __verify_planes_array_core, |
3c5be988 JS |
446 | .fill_user_buffer = __fill_v4l2_buffer, |
447 | .fill_vb2_buffer = __fill_vb2_buffer, | |
959c3ef3 | 448 | .copy_timestamp = __copy_timestamp, |
3c5be988 JS |
449 | }; |
450 | ||
451 | /** | |
452 | * vb2_querybuf() - query video buffer information | |
453 | * @q: videobuf queue | |
454 | * @b: buffer struct passed from userspace to vidioc_querybuf handler | |
455 | * in driver | |
456 | * | |
457 | * Should be called from vidioc_querybuf ioctl handler in driver. | |
458 | * This function will verify the passed v4l2_buffer structure and fill the | |
459 | * relevant information for the userspace. | |
460 | * | |
461 | * The return values from this function are intended to be directly returned | |
462 | * from vidioc_querybuf handler in driver. | |
463 | */ | |
464 | int vb2_querybuf(struct vb2_queue *q, struct v4l2_buffer *b) | |
465 | { | |
466 | struct vb2_buffer *vb; | |
467 | int ret; | |
468 | ||
469 | if (b->type != q->type) { | |
470 | dprintk(1, "wrong buffer type\n"); | |
471 | return -EINVAL; | |
472 | } | |
473 | ||
474 | if (b->index >= q->num_buffers) { | |
475 | dprintk(1, "buffer index out of range\n"); | |
476 | return -EINVAL; | |
477 | } | |
478 | vb = q->bufs[b->index]; | |
479 | ret = __verify_planes_array(vb, b); | |
10cc3b1e HV |
480 | if (!ret) |
481 | vb2_core_querybuf(q, b->index, b); | |
482 | return ret; | |
3c5be988 JS |
483 | } |
484 | EXPORT_SYMBOL(vb2_querybuf); | |
485 | ||
486 | /** | |
487 | * vb2_reqbufs() - Wrapper for vb2_core_reqbufs() that also verifies | |
488 | * the memory and type values. | |
489 | * @q: videobuf2 queue | |
490 | * @req: struct passed from userspace to vidioc_reqbufs handler | |
491 | * in driver | |
492 | */ | |
493 | int vb2_reqbufs(struct vb2_queue *q, struct v4l2_requestbuffers *req) | |
494 | { | |
495 | int ret = vb2_verify_memory_type(q, req->memory, req->type); | |
496 | ||
497 | return ret ? ret : vb2_core_reqbufs(q, req->memory, &req->count); | |
498 | } | |
499 | EXPORT_SYMBOL_GPL(vb2_reqbufs); | |
500 | ||
501 | /** | |
502 | * vb2_prepare_buf() - Pass ownership of a buffer from userspace to the kernel | |
503 | * @q: videobuf2 queue | |
504 | * @b: buffer structure passed from userspace to vidioc_prepare_buf | |
505 | * handler in driver | |
506 | * | |
507 | * Should be called from vidioc_prepare_buf ioctl handler of a driver. | |
508 | * This function: | |
509 | * 1) verifies the passed buffer, | |
510 | * 2) calls buf_prepare callback in the driver (if provided), in which | |
511 | * driver-specific buffer initialization can be performed, | |
512 | * | |
513 | * The return values from this function are intended to be directly returned | |
514 | * from vidioc_prepare_buf handler in driver. | |
515 | */ | |
516 | int vb2_prepare_buf(struct vb2_queue *q, struct v4l2_buffer *b) | |
517 | { | |
518 | int ret; | |
519 | ||
520 | if (vb2_fileio_is_active(q)) { | |
521 | dprintk(1, "file io in progress\n"); | |
522 | return -EBUSY; | |
523 | } | |
524 | ||
525 | ret = vb2_queue_or_prepare_buf(q, b, "prepare_buf"); | |
526 | ||
527 | return ret ? ret : vb2_core_prepare_buf(q, b->index, b); | |
528 | } | |
529 | EXPORT_SYMBOL_GPL(vb2_prepare_buf); | |
530 | ||
531 | /** | |
532 | * vb2_create_bufs() - Wrapper for vb2_core_create_bufs() that also verifies | |
533 | * the memory and type values. | |
534 | * @q: videobuf2 queue | |
535 | * @create: creation parameters, passed from userspace to vidioc_create_bufs | |
536 | * handler in driver | |
537 | */ | |
538 | int vb2_create_bufs(struct vb2_queue *q, struct v4l2_create_buffers *create) | |
539 | { | |
df9ecb0c HV |
540 | unsigned requested_planes = 1; |
541 | unsigned requested_sizes[VIDEO_MAX_PLANES]; | |
542 | struct v4l2_format *f = &create->format; | |
543 | int ret = vb2_verify_memory_type(q, create->memory, f->type); | |
544 | unsigned i; | |
3c5be988 JS |
545 | |
546 | create->index = q->num_buffers; | |
547 | if (create->count == 0) | |
548 | return ret != -EBUSY ? ret : 0; | |
df9ecb0c HV |
549 | |
550 | switch (f->type) { | |
551 | case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE: | |
552 | case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE: | |
553 | requested_planes = f->fmt.pix_mp.num_planes; | |
554 | if (requested_planes == 0 || | |
555 | requested_planes > VIDEO_MAX_PLANES) | |
556 | return -EINVAL; | |
557 | for (i = 0; i < requested_planes; i++) | |
558 | requested_sizes[i] = | |
559 | f->fmt.pix_mp.plane_fmt[i].sizeimage; | |
560 | break; | |
561 | case V4L2_BUF_TYPE_VIDEO_CAPTURE: | |
562 | case V4L2_BUF_TYPE_VIDEO_OUTPUT: | |
563 | requested_sizes[0] = f->fmt.pix.sizeimage; | |
564 | break; | |
565 | case V4L2_BUF_TYPE_VBI_CAPTURE: | |
566 | case V4L2_BUF_TYPE_VBI_OUTPUT: | |
567 | requested_sizes[0] = f->fmt.vbi.samples_per_line * | |
568 | (f->fmt.vbi.count[0] + f->fmt.vbi.count[1]); | |
569 | break; | |
570 | case V4L2_BUF_TYPE_SLICED_VBI_CAPTURE: | |
571 | case V4L2_BUF_TYPE_SLICED_VBI_OUTPUT: | |
572 | requested_sizes[0] = f->fmt.sliced.io_size; | |
573 | break; | |
574 | case V4L2_BUF_TYPE_SDR_CAPTURE: | |
575 | case V4L2_BUF_TYPE_SDR_OUTPUT: | |
576 | requested_sizes[0] = f->fmt.sdr.buffersize; | |
577 | break; | |
578 | default: | |
579 | return -EINVAL; | |
580 | } | |
581 | for (i = 0; i < requested_planes; i++) | |
582 | if (requested_sizes[i] == 0) | |
583 | return -EINVAL; | |
3c5be988 | 584 | return ret ? ret : vb2_core_create_bufs(q, create->memory, |
df9ecb0c | 585 | &create->count, requested_planes, requested_sizes); |
3c5be988 JS |
586 | } |
587 | EXPORT_SYMBOL_GPL(vb2_create_bufs); | |
588 | ||
3c5be988 JS |
589 | /** |
590 | * vb2_qbuf() - Queue a buffer from userspace | |
591 | * @q: videobuf2 queue | |
592 | * @b: buffer structure passed from userspace to vidioc_qbuf handler | |
593 | * in driver | |
594 | * | |
595 | * Should be called from vidioc_qbuf ioctl handler of a driver. | |
596 | * This function: | |
597 | * 1) verifies the passed buffer, | |
598 | * 2) if necessary, calls buf_prepare callback in the driver (if provided), in | |
599 | * which driver-specific buffer initialization can be performed, | |
600 | * 3) if streaming is on, queues the buffer in driver by the means of buf_queue | |
601 | * callback for processing. | |
602 | * | |
603 | * The return values from this function are intended to be directly returned | |
604 | * from vidioc_qbuf handler in driver. | |
605 | */ | |
606 | int vb2_qbuf(struct vb2_queue *q, struct v4l2_buffer *b) | |
607 | { | |
dfadf026 RRD |
608 | int ret; |
609 | ||
3c5be988 JS |
610 | if (vb2_fileio_is_active(q)) { |
611 | dprintk(1, "file io in progress\n"); | |
612 | return -EBUSY; | |
613 | } | |
614 | ||
dfadf026 RRD |
615 | ret = vb2_queue_or_prepare_buf(q, b, "qbuf"); |
616 | return ret ? ret : vb2_core_qbuf(q, b->index, b); | |
3c5be988 JS |
617 | } |
618 | EXPORT_SYMBOL_GPL(vb2_qbuf); | |
619 | ||
3c5be988 JS |
620 | /** |
621 | * vb2_dqbuf() - Dequeue a buffer to the userspace | |
622 | * @q: videobuf2 queue | |
623 | * @b: buffer structure passed from userspace to vidioc_dqbuf handler | |
624 | * in driver | |
625 | * @nonblocking: if true, this call will not sleep waiting for a buffer if no | |
626 | * buffers ready for dequeuing are present. Normally the driver | |
627 | * would be passing (file->f_flags & O_NONBLOCK) here | |
628 | * | |
629 | * Should be called from vidioc_dqbuf ioctl handler of a driver. | |
630 | * This function: | |
631 | * 1) verifies the passed buffer, | |
632 | * 2) calls buf_finish callback in the driver (if provided), in which | |
633 | * driver can perform any additional operations that may be required before | |
634 | * returning the buffer to userspace, such as cache sync, | |
635 | * 3) the buffer struct members are filled with relevant information for | |
636 | * the userspace. | |
637 | * | |
638 | * The return values from this function are intended to be directly returned | |
639 | * from vidioc_dqbuf handler in driver. | |
640 | */ | |
641 | int vb2_dqbuf(struct vb2_queue *q, struct v4l2_buffer *b, bool nonblocking) | |
642 | { | |
5256e057 RRD |
643 | int ret; |
644 | ||
3c5be988 JS |
645 | if (vb2_fileio_is_active(q)) { |
646 | dprintk(1, "file io in progress\n"); | |
647 | return -EBUSY; | |
648 | } | |
5256e057 RRD |
649 | |
650 | if (b->type != q->type) { | |
651 | dprintk(1, "invalid buffer type\n"); | |
652 | return -EINVAL; | |
653 | } | |
654 | ||
655 | ret = vb2_core_dqbuf(q, NULL, b, nonblocking); | |
656 | ||
657 | /* | |
658 | * After calling the VIDIOC_DQBUF V4L2_BUF_FLAG_DONE must be | |
659 | * cleared. | |
660 | */ | |
661 | b->flags &= ~V4L2_BUF_FLAG_DONE; | |
662 | ||
663 | return ret; | |
3c5be988 JS |
664 | } |
665 | EXPORT_SYMBOL_GPL(vb2_dqbuf); | |
666 | ||
667 | /** | |
668 | * vb2_streamon - start streaming | |
669 | * @q: videobuf2 queue | |
670 | * @type: type argument passed from userspace to vidioc_streamon handler | |
671 | * | |
672 | * Should be called from vidioc_streamon handler of a driver. | |
673 | * This function: | |
674 | * 1) verifies current state | |
675 | * 2) passes any previously queued buffers to the driver and starts streaming | |
676 | * | |
677 | * The return values from this function are intended to be directly returned | |
678 | * from vidioc_streamon handler in the driver. | |
679 | */ | |
680 | int vb2_streamon(struct vb2_queue *q, enum v4l2_buf_type type) | |
681 | { | |
682 | if (vb2_fileio_is_active(q)) { | |
683 | dprintk(1, "file io in progress\n"); | |
684 | return -EBUSY; | |
685 | } | |
686 | return vb2_core_streamon(q, type); | |
687 | } | |
688 | EXPORT_SYMBOL_GPL(vb2_streamon); | |
689 | ||
690 | /** | |
691 | * vb2_streamoff - stop streaming | |
692 | * @q: videobuf2 queue | |
693 | * @type: type argument passed from userspace to vidioc_streamoff handler | |
694 | * | |
695 | * Should be called from vidioc_streamoff handler of a driver. | |
696 | * This function: | |
697 | * 1) verifies current state, | |
698 | * 2) stop streaming and dequeues any queued buffers, including those previously | |
699 | * passed to the driver (after waiting for the driver to finish). | |
700 | * | |
701 | * This call can be used for pausing playback. | |
702 | * The return values from this function are intended to be directly returned | |
703 | * from vidioc_streamoff handler in the driver | |
704 | */ | |
705 | int vb2_streamoff(struct vb2_queue *q, enum v4l2_buf_type type) | |
706 | { | |
707 | if (vb2_fileio_is_active(q)) { | |
708 | dprintk(1, "file io in progress\n"); | |
709 | return -EBUSY; | |
710 | } | |
711 | return vb2_core_streamoff(q, type); | |
712 | } | |
713 | EXPORT_SYMBOL_GPL(vb2_streamoff); | |
714 | ||
715 | /** | |
716 | * vb2_expbuf() - Export a buffer as a file descriptor | |
717 | * @q: videobuf2 queue | |
718 | * @eb: export buffer structure passed from userspace to vidioc_expbuf | |
719 | * handler in driver | |
720 | * | |
721 | * The return values from this function are intended to be directly returned | |
722 | * from vidioc_expbuf handler in driver. | |
723 | */ | |
724 | int vb2_expbuf(struct vb2_queue *q, struct v4l2_exportbuffer *eb) | |
725 | { | |
726 | return vb2_core_expbuf(q, &eb->fd, eb->type, eb->index, | |
727 | eb->plane, eb->flags); | |
728 | } | |
729 | EXPORT_SYMBOL_GPL(vb2_expbuf); | |
730 | ||
731 | /** | |
732 | * vb2_queue_init() - initialize a videobuf2 queue | |
733 | * @q: videobuf2 queue; this structure should be allocated in driver | |
734 | * | |
735 | * The vb2_queue structure should be allocated by the driver. The driver is | |
736 | * responsible of clearing it's content and setting initial values for some | |
737 | * required entries before calling this function. | |
738 | * q->ops, q->mem_ops, q->type and q->io_modes are mandatory. Please refer | |
739 | * to the struct vb2_queue description in include/media/videobuf2-core.h | |
740 | * for more information. | |
741 | */ | |
742 | int vb2_queue_init(struct vb2_queue *q) | |
743 | { | |
744 | /* | |
745 | * Sanity check | |
746 | */ | |
747 | if (WARN_ON(!q) || | |
748 | WARN_ON(q->timestamp_flags & | |
749 | ~(V4L2_BUF_FLAG_TIMESTAMP_MASK | | |
750 | V4L2_BUF_FLAG_TSTAMP_SRC_MASK))) | |
751 | return -EINVAL; | |
752 | ||
753 | /* Warn that the driver should choose an appropriate timestamp type */ | |
754 | WARN_ON((q->timestamp_flags & V4L2_BUF_FLAG_TIMESTAMP_MASK) == | |
755 | V4L2_BUF_FLAG_TIMESTAMP_UNKNOWN); | |
756 | ||
757 | /* Warn that vb2_memory should match with v4l2_memory */ | |
758 | if (WARN_ON(VB2_MEMORY_MMAP != (int)V4L2_MEMORY_MMAP) | |
759 | || WARN_ON(VB2_MEMORY_USERPTR != (int)V4L2_MEMORY_USERPTR) | |
760 | || WARN_ON(VB2_MEMORY_DMABUF != (int)V4L2_MEMORY_DMABUF)) | |
761 | return -EINVAL; | |
762 | ||
763 | if (q->buf_struct_size == 0) | |
764 | q->buf_struct_size = sizeof(struct vb2_v4l2_buffer); | |
765 | ||
766 | q->buf_ops = &v4l2_buf_ops; | |
767 | q->is_multiplanar = V4L2_TYPE_IS_MULTIPLANAR(q->type); | |
768 | q->is_output = V4L2_TYPE_IS_OUTPUT(q->type); | |
959c3ef3 JS |
769 | q->copy_timestamp = (q->timestamp_flags & V4L2_BUF_FLAG_TIMESTAMP_MASK) |
770 | == V4L2_BUF_FLAG_TIMESTAMP_COPY; | |
b9387684 RRD |
771 | /* |
772 | * For compatibility with vb1: if QBUF hasn't been called yet, then | |
773 | * return POLLERR as well. This only affects capture queues, output | |
774 | * queues will always initialize waiting_for_buffers to false. | |
775 | */ | |
776 | q->quirk_poll_must_check_waiting_for_buffers = true; | |
3c5be988 JS |
777 | |
778 | return vb2_core_queue_init(q); | |
779 | } | |
780 | EXPORT_SYMBOL_GPL(vb2_queue_init); | |
781 | ||
3c5be988 JS |
782 | /** |
783 | * vb2_queue_release() - stop streaming, release the queue and free memory | |
784 | * @q: videobuf2 queue | |
785 | * | |
786 | * This function stops streaming and performs necessary clean ups, including | |
787 | * freeing video buffer memory. The driver is responsible for freeing | |
788 | * the vb2_queue structure itself. | |
789 | */ | |
790 | void vb2_queue_release(struct vb2_queue *q) | |
791 | { | |
3c5be988 JS |
792 | vb2_core_queue_release(q); |
793 | } | |
794 | EXPORT_SYMBOL_GPL(vb2_queue_release); | |
795 | ||
49d8ab9f JS |
796 | /** |
797 | * vb2_poll() - implements poll userspace operation | |
798 | * @q: videobuf2 queue | |
799 | * @file: file argument passed to the poll file operation handler | |
800 | * @wait: wait argument passed to the poll file operation handler | |
801 | * | |
802 | * This function implements poll file operation handler for a driver. | |
803 | * For CAPTURE queues, if a buffer is ready to be dequeued, the userspace will | |
804 | * be informed that the file descriptor of a video device is available for | |
805 | * reading. | |
806 | * For OUTPUT queues, if a buffer is ready to be dequeued, the file descriptor | |
807 | * will be reported as available for writing. | |
808 | * | |
809 | * If the driver uses struct v4l2_fh, then vb2_poll() will also check for any | |
810 | * pending events. | |
811 | * | |
812 | * The return values from this function are intended to be directly returned | |
813 | * from poll handler in driver. | |
814 | */ | |
815 | unsigned int vb2_poll(struct vb2_queue *q, struct file *file, poll_table *wait) | |
816 | { | |
817 | struct video_device *vfd = video_devdata(file); | |
818 | unsigned long req_events = poll_requested_events(wait); | |
819 | unsigned int res = 0; | |
820 | ||
821 | if (test_bit(V4L2_FL_USES_V4L2_FH, &vfd->flags)) { | |
822 | struct v4l2_fh *fh = file->private_data; | |
823 | ||
824 | if (v4l2_event_pending(fh)) | |
825 | res = POLLPRI; | |
826 | else if (req_events & POLLPRI) | |
827 | poll_wait(file, &fh->wait, wait); | |
3c5be988 | 828 | } |
49d8ab9f | 829 | |
49d8ab9f | 830 | return res | vb2_core_poll(q, file, wait); |
3c5be988 JS |
831 | } |
832 | EXPORT_SYMBOL_GPL(vb2_poll); | |
833 | ||
3c5be988 JS |
834 | /* |
835 | * The following functions are not part of the vb2 core API, but are helper | |
836 | * functions that plug into struct v4l2_ioctl_ops, struct v4l2_file_operations | |
837 | * and struct vb2_ops. | |
838 | * They contain boilerplate code that most if not all drivers have to do | |
839 | * and so they simplify the driver code. | |
840 | */ | |
841 | ||
842 | /* The queue is busy if there is a owner and you are not that owner. */ | |
843 | static inline bool vb2_queue_is_busy(struct video_device *vdev, struct file *file) | |
844 | { | |
845 | return vdev->queue->owner && vdev->queue->owner != file->private_data; | |
846 | } | |
847 | ||
848 | /* vb2 ioctl helpers */ | |
849 | ||
850 | int vb2_ioctl_reqbufs(struct file *file, void *priv, | |
851 | struct v4l2_requestbuffers *p) | |
852 | { | |
853 | struct video_device *vdev = video_devdata(file); | |
854 | int res = vb2_verify_memory_type(vdev->queue, p->memory, p->type); | |
855 | ||
856 | if (res) | |
857 | return res; | |
858 | if (vb2_queue_is_busy(vdev, file)) | |
859 | return -EBUSY; | |
860 | res = vb2_core_reqbufs(vdev->queue, p->memory, &p->count); | |
861 | /* If count == 0, then the owner has released all buffers and he | |
862 | is no longer owner of the queue. Otherwise we have a new owner. */ | |
863 | if (res == 0) | |
864 | vdev->queue->owner = p->count ? file->private_data : NULL; | |
865 | return res; | |
866 | } | |
867 | EXPORT_SYMBOL_GPL(vb2_ioctl_reqbufs); | |
868 | ||
869 | int vb2_ioctl_create_bufs(struct file *file, void *priv, | |
870 | struct v4l2_create_buffers *p) | |
871 | { | |
872 | struct video_device *vdev = video_devdata(file); | |
873 | int res = vb2_verify_memory_type(vdev->queue, p->memory, | |
874 | p->format.type); | |
875 | ||
876 | p->index = vdev->queue->num_buffers; | |
877 | /* | |
878 | * If count == 0, then just check if memory and type are valid. | |
879 | * Any -EBUSY result from vb2_verify_memory_type can be mapped to 0. | |
880 | */ | |
881 | if (p->count == 0) | |
882 | return res != -EBUSY ? res : 0; | |
883 | if (res) | |
884 | return res; | |
885 | if (vb2_queue_is_busy(vdev, file)) | |
886 | return -EBUSY; | |
df9ecb0c HV |
887 | |
888 | res = vb2_create_bufs(vdev->queue, p); | |
3c5be988 JS |
889 | if (res == 0) |
890 | vdev->queue->owner = file->private_data; | |
891 | return res; | |
892 | } | |
893 | EXPORT_SYMBOL_GPL(vb2_ioctl_create_bufs); | |
894 | ||
895 | int vb2_ioctl_prepare_buf(struct file *file, void *priv, | |
896 | struct v4l2_buffer *p) | |
897 | { | |
898 | struct video_device *vdev = video_devdata(file); | |
899 | ||
900 | if (vb2_queue_is_busy(vdev, file)) | |
901 | return -EBUSY; | |
902 | return vb2_prepare_buf(vdev->queue, p); | |
903 | } | |
904 | EXPORT_SYMBOL_GPL(vb2_ioctl_prepare_buf); | |
905 | ||
906 | int vb2_ioctl_querybuf(struct file *file, void *priv, struct v4l2_buffer *p) | |
907 | { | |
908 | struct video_device *vdev = video_devdata(file); | |
909 | ||
910 | /* No need to call vb2_queue_is_busy(), anyone can query buffers. */ | |
911 | return vb2_querybuf(vdev->queue, p); | |
912 | } | |
913 | EXPORT_SYMBOL_GPL(vb2_ioctl_querybuf); | |
914 | ||
915 | int vb2_ioctl_qbuf(struct file *file, void *priv, struct v4l2_buffer *p) | |
916 | { | |
917 | struct video_device *vdev = video_devdata(file); | |
918 | ||
919 | if (vb2_queue_is_busy(vdev, file)) | |
920 | return -EBUSY; | |
921 | return vb2_qbuf(vdev->queue, p); | |
922 | } | |
923 | EXPORT_SYMBOL_GPL(vb2_ioctl_qbuf); | |
924 | ||
925 | int vb2_ioctl_dqbuf(struct file *file, void *priv, struct v4l2_buffer *p) | |
926 | { | |
927 | struct video_device *vdev = video_devdata(file); | |
928 | ||
929 | if (vb2_queue_is_busy(vdev, file)) | |
930 | return -EBUSY; | |
931 | return vb2_dqbuf(vdev->queue, p, file->f_flags & O_NONBLOCK); | |
932 | } | |
933 | EXPORT_SYMBOL_GPL(vb2_ioctl_dqbuf); | |
934 | ||
935 | int vb2_ioctl_streamon(struct file *file, void *priv, enum v4l2_buf_type i) | |
936 | { | |
937 | struct video_device *vdev = video_devdata(file); | |
938 | ||
939 | if (vb2_queue_is_busy(vdev, file)) | |
940 | return -EBUSY; | |
941 | return vb2_streamon(vdev->queue, i); | |
942 | } | |
943 | EXPORT_SYMBOL_GPL(vb2_ioctl_streamon); | |
944 | ||
945 | int vb2_ioctl_streamoff(struct file *file, void *priv, enum v4l2_buf_type i) | |
946 | { | |
947 | struct video_device *vdev = video_devdata(file); | |
948 | ||
949 | if (vb2_queue_is_busy(vdev, file)) | |
950 | return -EBUSY; | |
951 | return vb2_streamoff(vdev->queue, i); | |
952 | } | |
953 | EXPORT_SYMBOL_GPL(vb2_ioctl_streamoff); | |
954 | ||
955 | int vb2_ioctl_expbuf(struct file *file, void *priv, struct v4l2_exportbuffer *p) | |
956 | { | |
957 | struct video_device *vdev = video_devdata(file); | |
958 | ||
959 | if (vb2_queue_is_busy(vdev, file)) | |
960 | return -EBUSY; | |
961 | return vb2_expbuf(vdev->queue, p); | |
962 | } | |
963 | EXPORT_SYMBOL_GPL(vb2_ioctl_expbuf); | |
964 | ||
965 | /* v4l2_file_operations helpers */ | |
966 | ||
967 | int vb2_fop_mmap(struct file *file, struct vm_area_struct *vma) | |
968 | { | |
969 | struct video_device *vdev = video_devdata(file); | |
970 | ||
971 | return vb2_mmap(vdev->queue, vma); | |
972 | } | |
973 | EXPORT_SYMBOL_GPL(vb2_fop_mmap); | |
974 | ||
975 | int _vb2_fop_release(struct file *file, struct mutex *lock) | |
976 | { | |
977 | struct video_device *vdev = video_devdata(file); | |
978 | ||
979 | if (lock) | |
980 | mutex_lock(lock); | |
981 | if (file->private_data == vdev->queue->owner) { | |
982 | vb2_queue_release(vdev->queue); | |
983 | vdev->queue->owner = NULL; | |
984 | } | |
985 | if (lock) | |
986 | mutex_unlock(lock); | |
987 | return v4l2_fh_release(file); | |
988 | } | |
989 | EXPORT_SYMBOL_GPL(_vb2_fop_release); | |
990 | ||
991 | int vb2_fop_release(struct file *file) | |
992 | { | |
993 | struct video_device *vdev = video_devdata(file); | |
994 | struct mutex *lock = vdev->queue->lock ? vdev->queue->lock : vdev->lock; | |
995 | ||
996 | return _vb2_fop_release(file, lock); | |
997 | } | |
998 | EXPORT_SYMBOL_GPL(vb2_fop_release); | |
999 | ||
1000 | ssize_t vb2_fop_write(struct file *file, const char __user *buf, | |
1001 | size_t count, loff_t *ppos) | |
1002 | { | |
1003 | struct video_device *vdev = video_devdata(file); | |
1004 | struct mutex *lock = vdev->queue->lock ? vdev->queue->lock : vdev->lock; | |
1005 | int err = -EBUSY; | |
1006 | ||
1007 | if (!(vdev->queue->io_modes & VB2_WRITE)) | |
1008 | return -EINVAL; | |
1009 | if (lock && mutex_lock_interruptible(lock)) | |
1010 | return -ERESTARTSYS; | |
1011 | if (vb2_queue_is_busy(vdev, file)) | |
1012 | goto exit; | |
1013 | err = vb2_write(vdev->queue, buf, count, ppos, | |
1014 | file->f_flags & O_NONBLOCK); | |
1015 | if (vdev->queue->fileio) | |
1016 | vdev->queue->owner = file->private_data; | |
1017 | exit: | |
1018 | if (lock) | |
1019 | mutex_unlock(lock); | |
1020 | return err; | |
1021 | } | |
1022 | EXPORT_SYMBOL_GPL(vb2_fop_write); | |
1023 | ||
1024 | ssize_t vb2_fop_read(struct file *file, char __user *buf, | |
1025 | size_t count, loff_t *ppos) | |
1026 | { | |
1027 | struct video_device *vdev = video_devdata(file); | |
1028 | struct mutex *lock = vdev->queue->lock ? vdev->queue->lock : vdev->lock; | |
1029 | int err = -EBUSY; | |
1030 | ||
1031 | if (!(vdev->queue->io_modes & VB2_READ)) | |
1032 | return -EINVAL; | |
1033 | if (lock && mutex_lock_interruptible(lock)) | |
1034 | return -ERESTARTSYS; | |
1035 | if (vb2_queue_is_busy(vdev, file)) | |
1036 | goto exit; | |
1037 | err = vb2_read(vdev->queue, buf, count, ppos, | |
1038 | file->f_flags & O_NONBLOCK); | |
1039 | if (vdev->queue->fileio) | |
1040 | vdev->queue->owner = file->private_data; | |
1041 | exit: | |
1042 | if (lock) | |
1043 | mutex_unlock(lock); | |
1044 | return err; | |
1045 | } | |
1046 | EXPORT_SYMBOL_GPL(vb2_fop_read); | |
1047 | ||
1048 | unsigned int vb2_fop_poll(struct file *file, poll_table *wait) | |
1049 | { | |
1050 | struct video_device *vdev = video_devdata(file); | |
1051 | struct vb2_queue *q = vdev->queue; | |
1052 | struct mutex *lock = q->lock ? q->lock : vdev->lock; | |
1053 | unsigned res; | |
1054 | void *fileio; | |
1055 | ||
1056 | /* | |
1057 | * If this helper doesn't know how to lock, then you shouldn't be using | |
1058 | * it but you should write your own. | |
1059 | */ | |
1060 | WARN_ON(!lock); | |
1061 | ||
1062 | if (lock && mutex_lock_interruptible(lock)) | |
1063 | return POLLERR; | |
1064 | ||
1065 | fileio = q->fileio; | |
1066 | ||
1067 | res = vb2_poll(vdev->queue, file, wait); | |
1068 | ||
1069 | /* If fileio was started, then we have a new queue owner. */ | |
1070 | if (!fileio && q->fileio) | |
1071 | q->owner = file->private_data; | |
1072 | if (lock) | |
1073 | mutex_unlock(lock); | |
1074 | return res; | |
1075 | } | |
1076 | EXPORT_SYMBOL_GPL(vb2_fop_poll); | |
1077 | ||
1078 | #ifndef CONFIG_MMU | |
1079 | unsigned long vb2_fop_get_unmapped_area(struct file *file, unsigned long addr, | |
1080 | unsigned long len, unsigned long pgoff, unsigned long flags) | |
1081 | { | |
1082 | struct video_device *vdev = video_devdata(file); | |
1083 | ||
1084 | return vb2_get_unmapped_area(vdev->queue, addr, len, pgoff, flags); | |
1085 | } | |
1086 | EXPORT_SYMBOL_GPL(vb2_fop_get_unmapped_area); | |
1087 | #endif | |
1088 | ||
1089 | /* vb2_ops helpers. Only use if vq->lock is non-NULL. */ | |
1090 | ||
1091 | void vb2_ops_wait_prepare(struct vb2_queue *vq) | |
1092 | { | |
1093 | mutex_unlock(vq->lock); | |
1094 | } | |
1095 | EXPORT_SYMBOL_GPL(vb2_ops_wait_prepare); | |
1096 | ||
1097 | void vb2_ops_wait_finish(struct vb2_queue *vq) | |
1098 | { | |
1099 | mutex_lock(vq->lock); | |
1100 | } | |
1101 | EXPORT_SYMBOL_GPL(vb2_ops_wait_finish); | |
1102 | ||
c139990e JS |
1103 | MODULE_DESCRIPTION("Driver helper framework for Video for Linux 2"); |
1104 | MODULE_AUTHOR("Pawel Osciak <pawel@osciak.com>, Marek Szyprowski"); | |
1105 | MODULE_LICENSE("GPL"); |