Commit f84dd900 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

doc-rst: linux_tv: Use references for read()/write()

Use cross-references for read()/write() on a few places
where they weren't used.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 863bd721
...@@ -97,6 +97,6 @@ requests and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_F ...@@ -97,6 +97,6 @@ requests and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_F
Reading Images Reading Images
============== ==============
A video capture device may support the :ref:`read() function <rw>` A video capture device may support the ::ref:`read() function <func-read>`
and/or streaming (:ref:`memory mapping <mmap>` or and/or streaming (:ref:`memory mapping <func-mmap>` or
:ref:`user pointer <userp>`) I/O. See :ref:`io` for details. :ref:`user pointer <userp>`) I/O. See :ref:`io` for details.
...@@ -91,8 +91,8 @@ happen for instance when the video and VBI areas to capture would ...@@ -91,8 +91,8 @@ happen for instance when the video and VBI areas to capture would
overlap, or when the driver supports multiple opens and another process overlap, or when the driver supports multiple opens and another process
already requested VBI capturing or output. Anyway, applications must already requested VBI capturing or output. Anyway, applications must
expect other resource allocation points which may return ``EBUSY``, at the expect other resource allocation points which may return ``EBUSY``, at the
:ref:`VIDIOC_STREAMON` ioctl and the first read(), :ref:`VIDIOC_STREAMON` ioctl and the first :ref:`read() <func-read>`
write() and select() call. , :ref:`write() <func-write>` and :ref:`select() <func-select>` calls.
VBI devices must implement both the :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` and VBI devices must implement both the :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` and
:ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl, even if :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ignores all requests :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl, even if :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ignores all requests
......
...@@ -32,12 +32,12 @@ Arguments ...@@ -32,12 +32,12 @@ Arguments
technicality, input devices still support only reading and output technicality, input devices still support only reading and output
devices only writing. devices only writing.
When the ``O_NONBLOCK`` flag is given, the read() function and the When the ``O_NONBLOCK`` flag is given, the :ref:`read() <func-read>`
:ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl will return the ``EAGAIN`` function and the :ref:`VIDIOC_DQBUF <VIDIOC_QBUF>` ioctl will
error code when no data is available or no buffer is in the driver return the ``EAGAIN`` error code when no data is available or no
outgoing queue, otherwise these functions block until data becomes buffer is in the driver outgoing queue, otherwise these functions
available. All V4L2 drivers exchanging data with applications must block until data becomes available. All V4L2 drivers exchanging data
support the ``O_NONBLOCK`` flag. with applications must support the ``O_NONBLOCK`` flag.
Other flags have no effect. Other flags have no effect.
......
...@@ -73,7 +73,8 @@ support all functions. However, in practice this never worked: this ...@@ -73,7 +73,8 @@ support all functions. However, in practice this never worked: this
'feature' was never used by applications and many drivers did not 'feature' was never used by applications and many drivers did not
support it and if they did it was certainly never tested. In addition, support it and if they did it was certainly never tested. In addition,
switching a device node between different functions only works when switching a device node between different functions only works when
using the streaming I/O API, not with the read()/write() API. using the streaming I/O API, not with the
:ref:`read() <func-read>`/\ :ref:`write() <func-write>` API.
Today each device node supports just one function. Today each device node supports just one function.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment