V4L/DVB: v4l videobuf: move video_copy_to_user and copy_stream to core
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / media / video / videobuf-core.c
blobf1dfcff44e1b856f49a718aeb53bfa753d33f3d4
1 /*
2 * generic helper functions for handling video4linux capture buffers
4 * (c) 2007 Mauro Carvalho Chehab, <mchehab@infradead.org>
6 * Highly based on video-buf written originally by:
7 * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org>
8 * (c) 2006 Mauro Carvalho Chehab, <mchehab@infradead.org>
9 * (c) 2006 Ted Walther and John Sokol
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2
16 #include <linux/init.h>
17 #include <linux/module.h>
18 #include <linux/moduleparam.h>
19 #include <linux/mm.h>
20 #include <linux/sched.h>
21 #include <linux/slab.h>
22 #include <linux/interrupt.h>
24 #include <media/videobuf-core.h>
26 #define MAGIC_BUFFER 0x20070728
27 #define MAGIC_CHECK(is, should) \
28 do { \
29 if (unlikely((is) != (should))) { \
30 printk(KERN_ERR \
31 "magic mismatch: %x (expected %x)\n", \
32 is, should); \
33 BUG(); \
34 } \
35 } while (0)
37 static int debug;
38 module_param(debug, int, 0644);
40 MODULE_DESCRIPTION("helper module to manage video4linux buffers");
41 MODULE_AUTHOR("Mauro Carvalho Chehab <mchehab@infradead.org>");
42 MODULE_LICENSE("GPL");
44 #define dprintk(level, fmt, arg...) \
45 do { \
46 if (debug >= level) \
47 printk(KERN_DEBUG "vbuf: " fmt, ## arg); \
48 } while (0)
50 /* --------------------------------------------------------------------- */
52 #define CALL(q, f, arg...) \
53 ((q->int_ops->f) ? q->int_ops->f(arg) : 0)
55 struct videobuf_buffer *videobuf_alloc(struct videobuf_queue *q)
57 struct videobuf_buffer *vb;
59 BUG_ON(q->msize < sizeof(*vb));
61 if (!q->int_ops || !q->int_ops->alloc) {
62 printk(KERN_ERR "No specific ops defined!\n");
63 BUG();
66 vb = q->int_ops->alloc(q->msize);
67 if (NULL != vb) {
68 init_waitqueue_head(&vb->done);
69 vb->magic = MAGIC_BUFFER;
72 return vb;
74 EXPORT_SYMBOL_GPL(videobuf_alloc);
76 #define WAITON_CONDITION (vb->state != VIDEOBUF_ACTIVE &&\
77 vb->state != VIDEOBUF_QUEUED)
78 int videobuf_waiton(struct videobuf_buffer *vb, int non_blocking, int intr)
80 MAGIC_CHECK(vb->magic, MAGIC_BUFFER);
82 if (non_blocking) {
83 if (WAITON_CONDITION)
84 return 0;
85 else
86 return -EAGAIN;
89 if (intr)
90 return wait_event_interruptible(vb->done, WAITON_CONDITION);
91 else
92 wait_event(vb->done, WAITON_CONDITION);
94 return 0;
96 EXPORT_SYMBOL_GPL(videobuf_waiton);
98 int videobuf_iolock(struct videobuf_queue *q, struct videobuf_buffer *vb,
99 struct v4l2_framebuffer *fbuf)
101 MAGIC_CHECK(vb->magic, MAGIC_BUFFER);
102 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
104 return CALL(q, iolock, q, vb, fbuf);
106 EXPORT_SYMBOL_GPL(videobuf_iolock);
108 void *videobuf_queue_to_vaddr(struct videobuf_queue *q,
109 struct videobuf_buffer *buf)
111 if (q->int_ops->vaddr)
112 return q->int_ops->vaddr(buf);
113 return NULL;
115 EXPORT_SYMBOL_GPL(videobuf_queue_to_vaddr);
117 /* --------------------------------------------------------------------- */
120 void videobuf_queue_core_init(struct videobuf_queue *q,
121 const struct videobuf_queue_ops *ops,
122 struct device *dev,
123 spinlock_t *irqlock,
124 enum v4l2_buf_type type,
125 enum v4l2_field field,
126 unsigned int msize,
127 void *priv,
128 struct videobuf_qtype_ops *int_ops)
130 BUG_ON(!q);
131 memset(q, 0, sizeof(*q));
132 q->irqlock = irqlock;
133 q->dev = dev;
134 q->type = type;
135 q->field = field;
136 q->msize = msize;
137 q->ops = ops;
138 q->priv_data = priv;
139 q->int_ops = int_ops;
141 /* All buffer operations are mandatory */
142 BUG_ON(!q->ops->buf_setup);
143 BUG_ON(!q->ops->buf_prepare);
144 BUG_ON(!q->ops->buf_queue);
145 BUG_ON(!q->ops->buf_release);
147 /* Lock is mandatory for queue_cancel to work */
148 BUG_ON(!irqlock);
150 /* Having implementations for abstract methods are mandatory */
151 BUG_ON(!q->int_ops);
153 mutex_init(&q->vb_lock);
154 init_waitqueue_head(&q->wait);
155 INIT_LIST_HEAD(&q->stream);
157 EXPORT_SYMBOL_GPL(videobuf_queue_core_init);
159 /* Locking: Only usage in bttv unsafe find way to remove */
160 int videobuf_queue_is_busy(struct videobuf_queue *q)
162 int i;
164 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
166 if (q->streaming) {
167 dprintk(1, "busy: streaming active\n");
168 return 1;
170 if (q->reading) {
171 dprintk(1, "busy: pending read #1\n");
172 return 1;
174 if (q->read_buf) {
175 dprintk(1, "busy: pending read #2\n");
176 return 1;
178 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
179 if (NULL == q->bufs[i])
180 continue;
181 if (q->bufs[i]->map) {
182 dprintk(1, "busy: buffer #%d mapped\n", i);
183 return 1;
185 if (q->bufs[i]->state == VIDEOBUF_QUEUED) {
186 dprintk(1, "busy: buffer #%d queued\n", i);
187 return 1;
189 if (q->bufs[i]->state == VIDEOBUF_ACTIVE) {
190 dprintk(1, "busy: buffer #%d avtive\n", i);
191 return 1;
194 return 0;
196 EXPORT_SYMBOL_GPL(videobuf_queue_is_busy);
198 /* Locking: Caller holds q->vb_lock */
199 void videobuf_queue_cancel(struct videobuf_queue *q)
201 unsigned long flags = 0;
202 int i;
204 q->streaming = 0;
205 q->reading = 0;
206 wake_up_interruptible_sync(&q->wait);
208 /* remove queued buffers from list */
209 spin_lock_irqsave(q->irqlock, flags);
210 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
211 if (NULL == q->bufs[i])
212 continue;
213 if (q->bufs[i]->state == VIDEOBUF_QUEUED) {
214 list_del(&q->bufs[i]->queue);
215 q->bufs[i]->state = VIDEOBUF_ERROR;
216 wake_up_all(&q->bufs[i]->done);
219 spin_unlock_irqrestore(q->irqlock, flags);
221 /* free all buffers + clear queue */
222 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
223 if (NULL == q->bufs[i])
224 continue;
225 q->ops->buf_release(q, q->bufs[i]);
227 INIT_LIST_HEAD(&q->stream);
229 EXPORT_SYMBOL_GPL(videobuf_queue_cancel);
231 /* --------------------------------------------------------------------- */
233 /* Locking: Caller holds q->vb_lock */
234 enum v4l2_field videobuf_next_field(struct videobuf_queue *q)
236 enum v4l2_field field = q->field;
238 BUG_ON(V4L2_FIELD_ANY == field);
240 if (V4L2_FIELD_ALTERNATE == field) {
241 if (V4L2_FIELD_TOP == q->last) {
242 field = V4L2_FIELD_BOTTOM;
243 q->last = V4L2_FIELD_BOTTOM;
244 } else {
245 field = V4L2_FIELD_TOP;
246 q->last = V4L2_FIELD_TOP;
249 return field;
251 EXPORT_SYMBOL_GPL(videobuf_next_field);
253 /* Locking: Caller holds q->vb_lock */
254 static void videobuf_status(struct videobuf_queue *q, struct v4l2_buffer *b,
255 struct videobuf_buffer *vb, enum v4l2_buf_type type)
257 MAGIC_CHECK(vb->magic, MAGIC_BUFFER);
258 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
260 b->index = vb->i;
261 b->type = type;
263 b->memory = vb->memory;
264 switch (b->memory) {
265 case V4L2_MEMORY_MMAP:
266 b->m.offset = vb->boff;
267 b->length = vb->bsize;
268 break;
269 case V4L2_MEMORY_USERPTR:
270 b->m.userptr = vb->baddr;
271 b->length = vb->bsize;
272 break;
273 case V4L2_MEMORY_OVERLAY:
274 b->m.offset = vb->boff;
275 break;
278 b->flags = 0;
279 if (vb->map)
280 b->flags |= V4L2_BUF_FLAG_MAPPED;
282 switch (vb->state) {
283 case VIDEOBUF_PREPARED:
284 case VIDEOBUF_QUEUED:
285 case VIDEOBUF_ACTIVE:
286 b->flags |= V4L2_BUF_FLAG_QUEUED;
287 break;
288 case VIDEOBUF_DONE:
289 case VIDEOBUF_ERROR:
290 b->flags |= V4L2_BUF_FLAG_DONE;
291 break;
292 case VIDEOBUF_NEEDS_INIT:
293 case VIDEOBUF_IDLE:
294 /* nothing */
295 break;
298 if (vb->input != UNSET) {
299 b->flags |= V4L2_BUF_FLAG_INPUT;
300 b->input = vb->input;
303 b->field = vb->field;
304 b->timestamp = vb->ts;
305 b->bytesused = vb->size;
306 b->sequence = vb->field_count >> 1;
309 /* Locking: Caller holds q->vb_lock */
310 static int __videobuf_mmap_free(struct videobuf_queue *q)
312 int i;
314 if (!q)
315 return 0;
317 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
319 for (i = 0; i < VIDEO_MAX_FRAME; i++)
320 if (q->bufs[i] && q->bufs[i]->map)
321 return -EBUSY;
323 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
324 if (NULL == q->bufs[i])
325 continue;
326 q->ops->buf_release(q, q->bufs[i]);
327 kfree(q->bufs[i]);
328 q->bufs[i] = NULL;
331 return 0;
334 int videobuf_mmap_free(struct videobuf_queue *q)
336 int ret;
337 mutex_lock(&q->vb_lock);
338 ret = __videobuf_mmap_free(q);
339 mutex_unlock(&q->vb_lock);
340 return ret;
342 EXPORT_SYMBOL_GPL(videobuf_mmap_free);
344 /* Locking: Caller holds q->vb_lock */
345 int __videobuf_mmap_setup(struct videobuf_queue *q,
346 unsigned int bcount, unsigned int bsize,
347 enum v4l2_memory memory)
349 unsigned int i;
350 int err;
352 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
354 err = __videobuf_mmap_free(q);
355 if (0 != err)
356 return err;
358 /* Allocate and initialize buffers */
359 for (i = 0; i < bcount; i++) {
360 q->bufs[i] = videobuf_alloc(q);
362 if (NULL == q->bufs[i])
363 break;
365 q->bufs[i]->i = i;
366 q->bufs[i]->input = UNSET;
367 q->bufs[i]->memory = memory;
368 q->bufs[i]->bsize = bsize;
369 switch (memory) {
370 case V4L2_MEMORY_MMAP:
371 q->bufs[i]->boff = PAGE_ALIGN(bsize) * i;
372 break;
373 case V4L2_MEMORY_USERPTR:
374 case V4L2_MEMORY_OVERLAY:
375 /* nothing */
376 break;
380 if (!i)
381 return -ENOMEM;
383 dprintk(1, "mmap setup: %d buffers, %d bytes each\n", i, bsize);
385 return i;
387 EXPORT_SYMBOL_GPL(__videobuf_mmap_setup);
389 int videobuf_mmap_setup(struct videobuf_queue *q,
390 unsigned int bcount, unsigned int bsize,
391 enum v4l2_memory memory)
393 int ret;
394 mutex_lock(&q->vb_lock);
395 ret = __videobuf_mmap_setup(q, bcount, bsize, memory);
396 mutex_unlock(&q->vb_lock);
397 return ret;
399 EXPORT_SYMBOL_GPL(videobuf_mmap_setup);
401 int videobuf_reqbufs(struct videobuf_queue *q,
402 struct v4l2_requestbuffers *req)
404 unsigned int size, count;
405 int retval;
407 if (req->count < 1) {
408 dprintk(1, "reqbufs: count invalid (%d)\n", req->count);
409 return -EINVAL;
412 if (req->memory != V4L2_MEMORY_MMAP &&
413 req->memory != V4L2_MEMORY_USERPTR &&
414 req->memory != V4L2_MEMORY_OVERLAY) {
415 dprintk(1, "reqbufs: memory type invalid\n");
416 return -EINVAL;
419 mutex_lock(&q->vb_lock);
420 if (req->type != q->type) {
421 dprintk(1, "reqbufs: queue type invalid\n");
422 retval = -EINVAL;
423 goto done;
426 if (q->streaming) {
427 dprintk(1, "reqbufs: streaming already exists\n");
428 retval = -EBUSY;
429 goto done;
431 if (!list_empty(&q->stream)) {
432 dprintk(1, "reqbufs: stream running\n");
433 retval = -EBUSY;
434 goto done;
437 count = req->count;
438 if (count > VIDEO_MAX_FRAME)
439 count = VIDEO_MAX_FRAME;
440 size = 0;
441 q->ops->buf_setup(q, &count, &size);
442 dprintk(1, "reqbufs: bufs=%d, size=0x%x [%u pages total]\n",
443 count, size,
444 (unsigned int)((count * PAGE_ALIGN(size)) >> PAGE_SHIFT));
446 retval = __videobuf_mmap_setup(q, count, size, req->memory);
447 if (retval < 0) {
448 dprintk(1, "reqbufs: mmap setup returned %d\n", retval);
449 goto done;
452 req->count = retval;
453 retval = 0;
455 done:
456 mutex_unlock(&q->vb_lock);
457 return retval;
459 EXPORT_SYMBOL_GPL(videobuf_reqbufs);
461 int videobuf_querybuf(struct videobuf_queue *q, struct v4l2_buffer *b)
463 int ret = -EINVAL;
465 mutex_lock(&q->vb_lock);
466 if (unlikely(b->type != q->type)) {
467 dprintk(1, "querybuf: Wrong type.\n");
468 goto done;
470 if (unlikely(b->index >= VIDEO_MAX_FRAME)) {
471 dprintk(1, "querybuf: index out of range.\n");
472 goto done;
474 if (unlikely(NULL == q->bufs[b->index])) {
475 dprintk(1, "querybuf: buffer is null.\n");
476 goto done;
479 videobuf_status(q, b, q->bufs[b->index], q->type);
481 ret = 0;
482 done:
483 mutex_unlock(&q->vb_lock);
484 return ret;
486 EXPORT_SYMBOL_GPL(videobuf_querybuf);
488 int videobuf_qbuf(struct videobuf_queue *q, struct v4l2_buffer *b)
490 struct videobuf_buffer *buf;
491 enum v4l2_field field;
492 unsigned long flags = 0;
493 int retval;
495 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
497 if (b->memory == V4L2_MEMORY_MMAP)
498 down_read(&current->mm->mmap_sem);
500 mutex_lock(&q->vb_lock);
501 retval = -EBUSY;
502 if (q->reading) {
503 dprintk(1, "qbuf: Reading running...\n");
504 goto done;
506 retval = -EINVAL;
507 if (b->type != q->type) {
508 dprintk(1, "qbuf: Wrong type.\n");
509 goto done;
511 if (b->index >= VIDEO_MAX_FRAME) {
512 dprintk(1, "qbuf: index out of range.\n");
513 goto done;
515 buf = q->bufs[b->index];
516 if (NULL == buf) {
517 dprintk(1, "qbuf: buffer is null.\n");
518 goto done;
520 MAGIC_CHECK(buf->magic, MAGIC_BUFFER);
521 if (buf->memory != b->memory) {
522 dprintk(1, "qbuf: memory type is wrong.\n");
523 goto done;
525 if (buf->state != VIDEOBUF_NEEDS_INIT && buf->state != VIDEOBUF_IDLE) {
526 dprintk(1, "qbuf: buffer is already queued or active.\n");
527 goto done;
530 if (b->flags & V4L2_BUF_FLAG_INPUT) {
531 if (b->input >= q->inputs) {
532 dprintk(1, "qbuf: wrong input.\n");
533 goto done;
535 buf->input = b->input;
536 } else {
537 buf->input = UNSET;
540 switch (b->memory) {
541 case V4L2_MEMORY_MMAP:
542 if (0 == buf->baddr) {
543 dprintk(1, "qbuf: mmap requested "
544 "but buffer addr is zero!\n");
545 goto done;
547 break;
548 case V4L2_MEMORY_USERPTR:
549 if (b->length < buf->bsize) {
550 dprintk(1, "qbuf: buffer length is not enough\n");
551 goto done;
553 if (VIDEOBUF_NEEDS_INIT != buf->state &&
554 buf->baddr != b->m.userptr)
555 q->ops->buf_release(q, buf);
556 buf->baddr = b->m.userptr;
557 break;
558 case V4L2_MEMORY_OVERLAY:
559 buf->boff = b->m.offset;
560 break;
561 default:
562 dprintk(1, "qbuf: wrong memory type\n");
563 goto done;
566 dprintk(1, "qbuf: requesting next field\n");
567 field = videobuf_next_field(q);
568 retval = q->ops->buf_prepare(q, buf, field);
569 if (0 != retval) {
570 dprintk(1, "qbuf: buffer_prepare returned %d\n", retval);
571 goto done;
574 list_add_tail(&buf->stream, &q->stream);
575 if (q->streaming) {
576 spin_lock_irqsave(q->irqlock, flags);
577 q->ops->buf_queue(q, buf);
578 spin_unlock_irqrestore(q->irqlock, flags);
580 dprintk(1, "qbuf: succeeded\n");
581 retval = 0;
582 wake_up_interruptible_sync(&q->wait);
584 done:
585 mutex_unlock(&q->vb_lock);
587 if (b->memory == V4L2_MEMORY_MMAP)
588 up_read(&current->mm->mmap_sem);
590 return retval;
592 EXPORT_SYMBOL_GPL(videobuf_qbuf);
594 /* Locking: Caller holds q->vb_lock */
595 static int stream_next_buffer_check_queue(struct videobuf_queue *q, int noblock)
597 int retval;
599 checks:
600 if (!q->streaming) {
601 dprintk(1, "next_buffer: Not streaming\n");
602 retval = -EINVAL;
603 goto done;
606 if (list_empty(&q->stream)) {
607 if (noblock) {
608 retval = -EAGAIN;
609 dprintk(2, "next_buffer: no buffers to dequeue\n");
610 goto done;
611 } else {
612 dprintk(2, "next_buffer: waiting on buffer\n");
614 /* Drop lock to avoid deadlock with qbuf */
615 mutex_unlock(&q->vb_lock);
617 /* Checking list_empty and streaming is safe without
618 * locks because we goto checks to validate while
619 * holding locks before proceeding */
620 retval = wait_event_interruptible(q->wait,
621 !list_empty(&q->stream) || !q->streaming);
622 mutex_lock(&q->vb_lock);
624 if (retval)
625 goto done;
627 goto checks;
631 retval = 0;
633 done:
634 return retval;
637 /* Locking: Caller holds q->vb_lock */
638 static int stream_next_buffer(struct videobuf_queue *q,
639 struct videobuf_buffer **vb, int nonblocking)
641 int retval;
642 struct videobuf_buffer *buf = NULL;
644 retval = stream_next_buffer_check_queue(q, nonblocking);
645 if (retval)
646 goto done;
648 buf = list_entry(q->stream.next, struct videobuf_buffer, stream);
649 retval = videobuf_waiton(buf, nonblocking, 1);
650 if (retval < 0)
651 goto done;
653 *vb = buf;
654 done:
655 return retval;
658 int videobuf_dqbuf(struct videobuf_queue *q,
659 struct v4l2_buffer *b, int nonblocking)
661 struct videobuf_buffer *buf = NULL;
662 int retval;
664 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
666 mutex_lock(&q->vb_lock);
668 retval = stream_next_buffer(q, &buf, nonblocking);
669 if (retval < 0) {
670 dprintk(1, "dqbuf: next_buffer error: %i\n", retval);
671 goto done;
674 switch (buf->state) {
675 case VIDEOBUF_ERROR:
676 dprintk(1, "dqbuf: state is error\n");
677 retval = -EIO;
678 CALL(q, sync, q, buf);
679 buf->state = VIDEOBUF_IDLE;
680 break;
681 case VIDEOBUF_DONE:
682 dprintk(1, "dqbuf: state is done\n");
683 CALL(q, sync, q, buf);
684 buf->state = VIDEOBUF_IDLE;
685 break;
686 default:
687 dprintk(1, "dqbuf: state invalid\n");
688 retval = -EINVAL;
689 goto done;
691 list_del(&buf->stream);
692 memset(b, 0, sizeof(*b));
693 videobuf_status(q, b, buf, q->type);
694 done:
695 mutex_unlock(&q->vb_lock);
696 return retval;
698 EXPORT_SYMBOL_GPL(videobuf_dqbuf);
700 int videobuf_streamon(struct videobuf_queue *q)
702 struct videobuf_buffer *buf;
703 unsigned long flags = 0;
704 int retval;
706 mutex_lock(&q->vb_lock);
707 retval = -EBUSY;
708 if (q->reading)
709 goto done;
710 retval = 0;
711 if (q->streaming)
712 goto done;
713 q->streaming = 1;
714 spin_lock_irqsave(q->irqlock, flags);
715 list_for_each_entry(buf, &q->stream, stream)
716 if (buf->state == VIDEOBUF_PREPARED)
717 q->ops->buf_queue(q, buf);
718 spin_unlock_irqrestore(q->irqlock, flags);
720 wake_up_interruptible_sync(&q->wait);
721 done:
722 mutex_unlock(&q->vb_lock);
723 return retval;
725 EXPORT_SYMBOL_GPL(videobuf_streamon);
727 /* Locking: Caller holds q->vb_lock */
728 static int __videobuf_streamoff(struct videobuf_queue *q)
730 if (!q->streaming)
731 return -EINVAL;
733 videobuf_queue_cancel(q);
735 return 0;
738 int videobuf_streamoff(struct videobuf_queue *q)
740 int retval;
742 mutex_lock(&q->vb_lock);
743 retval = __videobuf_streamoff(q);
744 mutex_unlock(&q->vb_lock);
746 return retval;
748 EXPORT_SYMBOL_GPL(videobuf_streamoff);
750 /* Locking: Caller holds q->vb_lock */
751 static ssize_t videobuf_read_zerocopy(struct videobuf_queue *q,
752 char __user *data,
753 size_t count, loff_t *ppos)
755 enum v4l2_field field;
756 unsigned long flags = 0;
757 int retval;
759 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
761 /* setup stuff */
762 q->read_buf = videobuf_alloc(q);
763 if (NULL == q->read_buf)
764 return -ENOMEM;
766 q->read_buf->memory = V4L2_MEMORY_USERPTR;
767 q->read_buf->baddr = (unsigned long)data;
768 q->read_buf->bsize = count;
770 field = videobuf_next_field(q);
771 retval = q->ops->buf_prepare(q, q->read_buf, field);
772 if (0 != retval)
773 goto done;
775 /* start capture & wait */
776 spin_lock_irqsave(q->irqlock, flags);
777 q->ops->buf_queue(q, q->read_buf);
778 spin_unlock_irqrestore(q->irqlock, flags);
779 retval = videobuf_waiton(q->read_buf, 0, 0);
780 if (0 == retval) {
781 CALL(q, sync, q, q->read_buf);
782 if (VIDEOBUF_ERROR == q->read_buf->state)
783 retval = -EIO;
784 else
785 retval = q->read_buf->size;
788 done:
789 /* cleanup */
790 q->ops->buf_release(q, q->read_buf);
791 kfree(q->read_buf);
792 q->read_buf = NULL;
793 return retval;
796 static int __videobuf_copy_to_user(struct videobuf_queue *q,
797 struct videobuf_buffer *buf,
798 char __user *data, size_t count,
799 int nonblocking)
801 void *vaddr = CALL(q, vaddr, buf);
803 /* copy to userspace */
804 if (count > buf->size - q->read_off)
805 count = buf->size - q->read_off;
807 if (copy_to_user(data, vaddr + q->read_off, count))
808 return -EFAULT;
810 return count;
813 static int __videobuf_copy_stream(struct videobuf_queue *q,
814 struct videobuf_buffer *buf,
815 char __user *data, size_t count, size_t pos,
816 int vbihack, int nonblocking)
818 unsigned int *fc = CALL(q, vaddr, buf);
820 if (vbihack) {
821 /* dirty, undocumented hack -- pass the frame counter
822 * within the last four bytes of each vbi data block.
823 * We need that one to maintain backward compatibility
824 * to all vbi decoding software out there ... */
825 fc += (buf->size >> 2) - 1;
826 *fc = buf->field_count >> 1;
827 dprintk(1, "vbihack: %d\n", *fc);
830 /* copy stuff using the common method */
831 count = __videobuf_copy_to_user(q, buf, data, count, nonblocking);
833 if ((count == -EFAULT) && (pos == 0))
834 return -EFAULT;
836 return count;
839 ssize_t videobuf_read_one(struct videobuf_queue *q,
840 char __user *data, size_t count, loff_t *ppos,
841 int nonblocking)
843 enum v4l2_field field;
844 unsigned long flags = 0;
845 unsigned size = 0, nbufs = 1;
846 int retval;
848 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
850 mutex_lock(&q->vb_lock);
852 q->ops->buf_setup(q, &nbufs, &size);
854 if (NULL == q->read_buf &&
855 count >= size &&
856 !nonblocking) {
857 retval = videobuf_read_zerocopy(q, data, count, ppos);
858 if (retval >= 0 || retval == -EIO)
859 /* ok, all done */
860 goto done;
861 /* fallback to kernel bounce buffer on failures */
864 if (NULL == q->read_buf) {
865 /* need to capture a new frame */
866 retval = -ENOMEM;
867 q->read_buf = videobuf_alloc(q);
869 dprintk(1, "video alloc=0x%p\n", q->read_buf);
870 if (NULL == q->read_buf)
871 goto done;
872 q->read_buf->memory = V4L2_MEMORY_USERPTR;
873 q->read_buf->bsize = count; /* preferred size */
874 field = videobuf_next_field(q);
875 retval = q->ops->buf_prepare(q, q->read_buf, field);
877 if (0 != retval) {
878 kfree(q->read_buf);
879 q->read_buf = NULL;
880 goto done;
883 spin_lock_irqsave(q->irqlock, flags);
884 q->ops->buf_queue(q, q->read_buf);
885 spin_unlock_irqrestore(q->irqlock, flags);
887 q->read_off = 0;
890 /* wait until capture is done */
891 retval = videobuf_waiton(q->read_buf, nonblocking, 1);
892 if (0 != retval)
893 goto done;
895 CALL(q, sync, q, q->read_buf);
897 if (VIDEOBUF_ERROR == q->read_buf->state) {
898 /* catch I/O errors */
899 q->ops->buf_release(q, q->read_buf);
900 kfree(q->read_buf);
901 q->read_buf = NULL;
902 retval = -EIO;
903 goto done;
906 /* Copy to userspace */
907 retval = __videobuf_copy_to_user(q, q->read_buf, data, count, nonblocking);
908 if (retval < 0)
909 goto done;
911 q->read_off += retval;
912 if (q->read_off == q->read_buf->size) {
913 /* all data copied, cleanup */
914 q->ops->buf_release(q, q->read_buf);
915 kfree(q->read_buf);
916 q->read_buf = NULL;
919 done:
920 mutex_unlock(&q->vb_lock);
921 return retval;
923 EXPORT_SYMBOL_GPL(videobuf_read_one);
925 /* Locking: Caller holds q->vb_lock */
926 static int __videobuf_read_start(struct videobuf_queue *q)
928 enum v4l2_field field;
929 unsigned long flags = 0;
930 unsigned int count = 0, size = 0;
931 int err, i;
933 q->ops->buf_setup(q, &count, &size);
934 if (count < 2)
935 count = 2;
936 if (count > VIDEO_MAX_FRAME)
937 count = VIDEO_MAX_FRAME;
938 size = PAGE_ALIGN(size);
940 err = __videobuf_mmap_setup(q, count, size, V4L2_MEMORY_USERPTR);
941 if (err < 0)
942 return err;
944 count = err;
946 for (i = 0; i < count; i++) {
947 field = videobuf_next_field(q);
948 err = q->ops->buf_prepare(q, q->bufs[i], field);
949 if (err)
950 return err;
951 list_add_tail(&q->bufs[i]->stream, &q->stream);
953 spin_lock_irqsave(q->irqlock, flags);
954 for (i = 0; i < count; i++)
955 q->ops->buf_queue(q, q->bufs[i]);
956 spin_unlock_irqrestore(q->irqlock, flags);
957 q->reading = 1;
958 return 0;
961 static void __videobuf_read_stop(struct videobuf_queue *q)
963 int i;
965 videobuf_queue_cancel(q);
966 __videobuf_mmap_free(q);
967 INIT_LIST_HEAD(&q->stream);
968 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
969 if (NULL == q->bufs[i])
970 continue;
971 kfree(q->bufs[i]);
972 q->bufs[i] = NULL;
974 q->read_buf = NULL;
977 int videobuf_read_start(struct videobuf_queue *q)
979 int rc;
981 mutex_lock(&q->vb_lock);
982 rc = __videobuf_read_start(q);
983 mutex_unlock(&q->vb_lock);
985 return rc;
987 EXPORT_SYMBOL_GPL(videobuf_read_start);
989 void videobuf_read_stop(struct videobuf_queue *q)
991 mutex_lock(&q->vb_lock);
992 __videobuf_read_stop(q);
993 mutex_unlock(&q->vb_lock);
995 EXPORT_SYMBOL_GPL(videobuf_read_stop);
997 void videobuf_stop(struct videobuf_queue *q)
999 mutex_lock(&q->vb_lock);
1001 if (q->streaming)
1002 __videobuf_streamoff(q);
1004 if (q->reading)
1005 __videobuf_read_stop(q);
1007 mutex_unlock(&q->vb_lock);
1009 EXPORT_SYMBOL_GPL(videobuf_stop);
1011 ssize_t videobuf_read_stream(struct videobuf_queue *q,
1012 char __user *data, size_t count, loff_t *ppos,
1013 int vbihack, int nonblocking)
1015 int rc, retval;
1016 unsigned long flags = 0;
1018 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
1020 dprintk(2, "%s\n", __func__);
1021 mutex_lock(&q->vb_lock);
1022 retval = -EBUSY;
1023 if (q->streaming)
1024 goto done;
1025 if (!q->reading) {
1026 retval = __videobuf_read_start(q);
1027 if (retval < 0)
1028 goto done;
1031 retval = 0;
1032 while (count > 0) {
1033 /* get / wait for data */
1034 if (NULL == q->read_buf) {
1035 q->read_buf = list_entry(q->stream.next,
1036 struct videobuf_buffer,
1037 stream);
1038 list_del(&q->read_buf->stream);
1039 q->read_off = 0;
1041 rc = videobuf_waiton(q->read_buf, nonblocking, 1);
1042 if (rc < 0) {
1043 if (0 == retval)
1044 retval = rc;
1045 break;
1048 if (q->read_buf->state == VIDEOBUF_DONE) {
1049 rc = __videobuf_copy_stream(q, q->read_buf, data + retval, count,
1050 retval, vbihack, nonblocking);
1051 if (rc < 0) {
1052 retval = rc;
1053 break;
1055 retval += rc;
1056 count -= rc;
1057 q->read_off += rc;
1058 } else {
1059 /* some error */
1060 q->read_off = q->read_buf->size;
1061 if (0 == retval)
1062 retval = -EIO;
1065 /* requeue buffer when done with copying */
1066 if (q->read_off == q->read_buf->size) {
1067 list_add_tail(&q->read_buf->stream,
1068 &q->stream);
1069 spin_lock_irqsave(q->irqlock, flags);
1070 q->ops->buf_queue(q, q->read_buf);
1071 spin_unlock_irqrestore(q->irqlock, flags);
1072 q->read_buf = NULL;
1074 if (retval < 0)
1075 break;
1078 done:
1079 mutex_unlock(&q->vb_lock);
1080 return retval;
1082 EXPORT_SYMBOL_GPL(videobuf_read_stream);
1084 unsigned int videobuf_poll_stream(struct file *file,
1085 struct videobuf_queue *q,
1086 poll_table *wait)
1088 struct videobuf_buffer *buf = NULL;
1089 unsigned int rc = 0;
1091 mutex_lock(&q->vb_lock);
1092 if (q->streaming) {
1093 if (!list_empty(&q->stream))
1094 buf = list_entry(q->stream.next,
1095 struct videobuf_buffer, stream);
1096 } else {
1097 if (!q->reading)
1098 __videobuf_read_start(q);
1099 if (!q->reading) {
1100 rc = POLLERR;
1101 } else if (NULL == q->read_buf) {
1102 q->read_buf = list_entry(q->stream.next,
1103 struct videobuf_buffer,
1104 stream);
1105 list_del(&q->read_buf->stream);
1106 q->read_off = 0;
1108 buf = q->read_buf;
1110 if (!buf)
1111 rc = POLLERR;
1113 if (0 == rc) {
1114 poll_wait(file, &buf->done, wait);
1115 if (buf->state == VIDEOBUF_DONE ||
1116 buf->state == VIDEOBUF_ERROR)
1117 rc = POLLIN|POLLRDNORM;
1119 mutex_unlock(&q->vb_lock);
1120 return rc;
1122 EXPORT_SYMBOL_GPL(videobuf_poll_stream);
1124 int videobuf_mmap_mapper(struct videobuf_queue *q, struct vm_area_struct *vma)
1126 int retval;
1128 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
1130 mutex_lock(&q->vb_lock);
1131 retval = CALL(q, mmap_mapper, q, vma);
1132 mutex_unlock(&q->vb_lock);
1134 return retval;
1136 EXPORT_SYMBOL_GPL(videobuf_mmap_mapper);
1138 #ifdef CONFIG_VIDEO_V4L1_COMPAT
1139 int videobuf_cgmbuf(struct videobuf_queue *q,
1140 struct video_mbuf *mbuf, int count)
1142 struct v4l2_requestbuffers req;
1143 int rc, i;
1145 MAGIC_CHECK(q->int_ops->magic, MAGIC_QTYPE_OPS);
1147 memset(&req, 0, sizeof(req));
1148 req.type = q->type;
1149 req.count = count;
1150 req.memory = V4L2_MEMORY_MMAP;
1151 rc = videobuf_reqbufs(q, &req);
1152 if (rc < 0)
1153 return rc;
1155 mbuf->frames = req.count;
1156 mbuf->size = 0;
1157 for (i = 0; i < mbuf->frames; i++) {
1158 mbuf->offsets[i] = q->bufs[i]->boff;
1159 mbuf->size += PAGE_ALIGN(q->bufs[i]->bsize);
1162 return 0;
1164 EXPORT_SYMBOL_GPL(videobuf_cgmbuf);
1165 #endif