1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
.. -*- coding: utf-8; mode: rst -*-
.. _func-select:
*************
V4L2 select()
*************
*man v4l2-select(2)*
Synchronous I/O multiplexing
Synopsis
========
.. code-block:: c
#include <sys/time.h>
#include <sys/types.h>
#include <unistd.h>
.. c:function:: int select( int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval *timeout )
Description
===========
With the :c:func:`select()` function applications can suspend
execution until the driver has captured data or is ready to accept data
for output.
When streaming I/O has been negotiated this function waits until a
buffer has been filled or displayed and can be dequeued with the
:ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. When buffers are already in
the outgoing queue of the driver the function returns immediately.
On success :c:func:`select()` returns the total number of bits set in
the :c:type:`struct fd_set`s. When the function timed out it returns
a value of zero. On failure it returns -1 and the ``errno`` variable is
set appropriately. When the application did not call
:ref:`VIDIOC_QBUF <vidioc-qbuf>` or
:ref:`VIDIOC_STREAMON <vidioc-streamon>` yet the :c:func:`select()`
function succeeds, setting the bit of the file descriptor in ``readfds``
or ``writefds``, but subsequent :ref:`VIDIOC_DQBUF <vidioc-qbuf>`
calls will fail. [1]_
When use of the :c:func:`read()` function has been negotiated and the
driver does not capture yet, the :c:func:`select()` function starts
capturing. When that fails, :c:func:`select()` returns successful and
a subsequent :c:func:`read()` call, which also attempts to start
capturing, will return an appropriate error code. When the driver
captures continuously (as opposed to, for example, still images) and
data is already available the :c:func:`select()` function returns
immediately.
When use of the :c:func:`write()` function has been negotiated the
:c:func:`select()` function just waits until the driver is ready for a
non-blocking :c:func:`write()` call.
All drivers implementing the :c:func:`read()` or :c:func:`write()`
function or streaming I/O must also support the :c:func:`select()`
function.
For more details see the :c:func:`select()` manual page.
Return Value
============
On success, :c:func:`select()` returns the number of descriptors
contained in the three returned descriptor sets, which will be zero if
the timeout expired. On error -1 is returned, and the ``errno`` variable
is set appropriately; the sets and ``timeout`` are undefined. Possible
error codes are:
EBADF
One or more of the file descriptor sets specified a file descriptor
that is not open.
EBUSY
The driver does not support multiple read or write streams and the
device is already in use.
EFAULT
The ``readfds``, ``writefds``, ``exceptfds`` or ``timeout`` pointer
references an inaccessible memory area.
EINTR
The call was interrupted by a signal.
EINVAL
The ``nfds`` argument is less than zero or greater than
``FD_SETSIZE``.
.. [1]
The Linux kernel implements :c:func:`select()` like the
:ref:`poll() <func-poll>` function, but :c:func:`select()` cannot
return a ``POLLERR``.
.. ------------------------------------------------------------------------------
.. This file was automatically converted from DocBook-XML with the dbxml
.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
.. from the linux kernel, refer to:
..
.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
.. ------------------------------------------------------------------------------
|
